使用 Factory Droid 集成 GenStudio API

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

获取 API 接入信息

在配置之前，您需要先确定所选的服务模式以获取对应的 API Key。

注意

在调用接口时，不同的应用或客户端工具可能需要您输入完整的 Endpoint（Base URL + 具体路径），或者分别输入 Base URL 与路径。请根据所用工具的要求提供以下参数。

Infini 编码套餐 (Coding Plan)

适用于订阅了预付费编程套餐的开发者，提供专享配额与预算控制。Coding Plan 使用专用的 Base URL 和 Endpoints，请根据您的客户端工具支持的协议（OpenAI 兼容或 Anthropic）来配置。详见 Infini 编码套餐。

• API Key：前往编码套餐页面创建 API 密钥。Infini 编码套餐专用 API 密钥均带有 sk-cp- 前缀。

  获取编码套餐 API 密钥

  注意

  Infini 编码套餐 (Coding Plan) 仅支持部分模型。实际支持情况请以平台编码套餐页面显示为准。

• OpenAI (OpenAI Compatible)

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

• Anthropic (Anthropic Messages)

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

GenStudio 通用 LLM API

适用于按量付费、包并发服务，或希望免费体验（基础服务）的用户，可用于大语言模型、生图模型、视频模型等。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

在 Droid 中集成 GenStudio API 服务

安装 Droid

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

macOS / Linux：

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

Windows：

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。

{
  "customModels": [
    {
      "displayName": "GenStudio-MiniMax-M2.5",
      "model": "minimax-m2.5",
      "baseUrl": "https://cloud.infini-ai.com/maas",
      // [TIP] 如果您订阅了 Infini 编码套餐 (Coding Plan)，请将 baseUrl 修改为 https://cloud.infini-ai.com/maas/coding
      "apiKey": "YOUR_GENSTUDIO_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "displayName": "GenStudio-GLM-5",
      "model": "glm-5",
      "baseUrl": "https://cloud.infini-ai.com/maas",
      "apiKey": "YOUR_GENSTUDIO_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    }
  ]
}

注意

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

OpenAI 兼容模型配置示例：

{
  "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
}

Anthropic 协议模型支持范围

GenStudio 仅为部分模型提供 Anthropic Messages 兼容接口。最新支持情况，请前往 GenStudio 模型广场，使用「Claude 兼容」筛选条件查看支持的模型列表。

模型广场

注意

如您已订阅 Infini 编码套餐 (Coding Plan) ，请注意编码套餐仅支持部分模型。请访问平台编码套餐页面，以实际显示为准。

选择模型并启动

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

   cd /path/to/your/project
   droid

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

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

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

相关资源

• Factory Droid 官方文档 - BYOK
• 使用 OpenCode 集成 GenStudio API
• 使用 Claude Code 集成 GenStudio API