使用 Factory Droid 集成 GenStudio API

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

获取 GenStudio API Key

您可以复制已有 API Key 或创建新的 Key。

获取 API 密钥

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

在 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.1",
      "model": "minimax-m2.1",
      "baseUrl": "https://cloud.infini-ai.com/maas",
      "apiKey": "YOUR_GENSTUDIO_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "displayName": "GenStudio-GLM-4.7",
      "model": "glm-4.7",
      "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 兼容」筛选条件查看支持的模型列表。

模型广场

选择模型并启动

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