文档中心

Appearance

✨充值控制台

使用 Factory Droid 集成 GenStudio API ​

Factory Droid 是一款在终端中运行的 AI 编程助手。它支持通过配置自定义模型来连接第三方 API 服务。本教程将指导用户如何在 Droid 中集成 GenStudio 的 API 服务。

获取 API 接入信息 ​

在配置之前，您需要先获取对应的 API Key。

GenStudio 通用 LLM API ​

适用于按量付费、包并发服务等场景，可用于大语言模型、生图模型、视频模型等。LLM API 按 Token 计费，请关注账户余额。GenStudio 通用 LLM API 使用平台通用的的 Base URL 和 Endpoints，请根据您的客户端工具支持的协议（OpenAI 兼容或 Anthropic）来配置。

  • API Key： 创建以 sk- 前缀的 API 密钥。详见 GenStudio API 快速集成。

    获取通用 API Key

    信息

    GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费，以及享受的 API 频率上限。详见 LLM API 计费规则。

  • OpenAI (OpenAI Compatible)

    • Base URL: https://cloud.infini-ai.com/maas/v1
    • Endpoints
      • Create Chat Completion: /chat/completions
      • List Models: /models

  • Anthropic (Anthropic Messages)

    • Base URL: https://cloud.infini-ai.com/maas
    • Endpoints
      • Create a Message: /v1/messages
      • List Models: /v1/models

通过 API 获取最新可用模型列表 ​

若需获取当前接入方式下最新可用的模型 ID，建议通过 Agent 或手动调用模型列表接口。

该接口仅返回当前可用的模型列表，不返回上下文长度、最大输出长度等模型元数据。请使用通用 API Key（sk- 前缀）查询。

language-shell
curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

在控制台查看上下文长度和最大输出长度 ​

如需查看模型的上下文长度和最大输出长度，请前往模型广场查看对应模型卡片。模型卡片会展示每个模型的上下文长度、最大输出长度等信息。

打开模型广场

在 Droid 中集成 GenStudio API 服务 ​

安装 Droid ​

如果您尚未安装 Droid，可以使用官方安装脚本进行安装：

macOS / Linux：

language-shell
curl -fsSL https://app.factory.ai/cli | sh

Windows：

language-powershell
irm https://app.factory.ai/cli/windows | iex

配置 Droid ​

Droid 使用配置文件来管理自定义模型。推荐的配置文件路径为 ~/.factory/settings.json。

信息

配置文件兼容性说明 Droid 支持两种配置文件格式：

  1. 推荐：~/.factory/settings.json（使用 camelCase 驼峰命名，如 customModels, baseUrl）
  2. 旧版兼容：~/.factory/config.json（使用 snake_case 下划线命名，如 custom_models, base_url）

两个文件会被同时加载并合并，但 settings.json 中的配置优先级更高。本教程使用推荐的 settings.json 格式。

如果该文件不存在，请手动创建。

警告

清除冲突环境变量 在配置前，请确保清除以下 Anthropic 相关的环境变量，以免影响 GenStudio API 的正常使用：

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL

如果存在 ANTHROPIC_AUTH_TOKEN，它可能会覆盖配置文件中的 API Key 并导致认证错误。

将以下内容添加到 ~/.factory/settings.json 中。请注意将 YOUR_GENSTUDIO_API_KEY 替换为您真实的 API Key。

language-json
{
  "customModels": [
    {
      "displayName": "GenStudio-MiniMax-M2.5",
      "model": "minimax-m2.5",
      "baseUrl": "https://cloud.infini-ai.com/maas",
      "apiKey": "YOUR_GENSTUDIO_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "displayName": "GenStudio-GLM-5.1",
      "model": "glm-5.1",
      "baseUrl": "https://cloud.infini-ai.com/maas",
      "apiKey": "YOUR_GENSTUDIO_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    }
  ]
}

信息

关于 Provider 类型 对于 DeepSeek、Kimi 等 OpenAI 兼容模型，GenStudio 提供的是 Chat Completions API。在 Droid 中，请将 provider 设置为 "generic-chat-completion-api"（而非 "openai"，因为 "openai" 对应的是 Responses API）。

OpenAI 兼容模型配置示例：

language-json
{
  "displayName": "GenStudio-DeepSeek-V3",
  "model": "deepseek-v3",
  "baseUrl": "https://cloud.infini-ai.com/maas/v1",
  "apiKey": "YOUR_GENSTUDIO_API_KEY",
  "provider": "generic-chat-completion-api",
  "maxOutputTokens": 8192
}

选择模型并启动 ​

  1. 进入您的项目目录并启动 Droid：

    language-shell
    cd /path/to/your/project
droid

  2. 在 Droid 界面中输入 /model 命令。

  3. 在列表中选择您配置的模型（例如 GenStudio-MiniMax-M2.1）。

现在，您就可以使用 GenStudio 的模型服务来驱动 Droid 进行编程了。

相关文档 ​