使用 Factory Droid 集成 GenStudio API
注意
适用版本
本文以 Factory Droid 1.9.0 为准。运行 droid --version 可查看本地版本。
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 快速集成。注意
GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费,以及享受的 API 频率上限。详见 LLM API 计费规则。
OpenAI (OpenAI Compatible)
Base URL:
https://cloud.infini-ai.com/maas/v1Endpoints
- Create Chat Completion:
/chat/completions - List Models:
/models
- Create Chat Completion:
Anthropic (Anthropic Messages)
Base URL:
https://cloud.infini-ai.com/maasEndpoints
- Create a Message:
/v1/messages - List Models:
/v1/models
- Create a Message:
通过 API 获取最新可用模型列表
若需获取当前接入方式下最新可用的模型 ID,建议通过 Agent 或手动调用模型列表接口。
该接口仅返回当前可用的模型列表,不返回上下文长度、最大输出长度等模型元数据。请使用通用 API Key(sk- 前缀)查询。
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:
curl -fsSL https://app.factory.ai/cli | shWindows:
irm https://app.factory.ai/cli/windows | iex配置 Droid
Droid 使用配置文件来管理自定义模型。推荐的配置文件路径为 ~/.factory/settings.json。
注意
配置文件兼容性说明 Droid 支持两种配置文件格式:
- 推荐:
~/.factory/settings.json(使用camelCase驼峰命名,如customModels,baseUrl) - 旧版兼容:
~/.factory/config.json(使用snake_case下划线命名,如custom_models,base_url)
两个文件会被同时加载并合并,但 settings.json 中的配置优先级更高。本教程使用推荐的 settings.json 格式。
如果该文件不存在,请手动创建。
警告
清除冲突环境变量 在配置前,请确保清除以下 Anthropic 相关的环境变量,以免影响 GenStudio API 的正常使用:
ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL
如果存在 ANTHROPIC_AUTH_TOKEN,它可能会覆盖配置文件中的 API Key 并导致认证错误。
以下示例通过 Anthropic Messages 接口接入 minimax-m2.7 和 glm-5.1。将以下内容添加到 ~/.factory/settings.json 中,并将 YOUR_GENSTUDIO_API_KEY 替换为您的 API Key。
{
"customModels": [
{
"displayName": "GenStudio-MiniMax-M2.7",
"model": "minimax-m2.7",
"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
}
]
}注意
以上模型仅为示例。GenStudio 当前可用的模型及其 ID,以 GenStudio 模型广场或 /models 接口的返回结果为准。provider 为 "anthropic" 的模型需要支持 Anthropic Messages 接口,可在模型广场使用「Claude 兼容」筛选条件查看。
使用 Chat Completions 时,将模型条目的 provider 设置为 "generic-chat-completion-api",并将 baseUrl 设置为对应接入方式的 OpenAI 兼容 Base URL。
配置 Responses 模型
以下以 deepseek-v4.1-flash-1017 为例,演示如何通过 Responses 协议接入 GenStudio 模型。您可以从模型广场或 /models 获取当前账号可用的模型 ID,并确认所选模型支持 Responses。
在启动 Droid 的终端中设置
GENSTUDIO_API_KEY。将YOUR_GENSTUDIO_API_KEY替换为您的 GenStudio 通用 API Key。macOS / Linux
language-shellexport GENSTUDIO_API_KEY='YOUR_GENSTUDIO_API_KEY'Windows PowerShell
language-powershell$env:GENSTUDIO_API_KEY = 'YOUR_GENSTUDIO_API_KEY'在
~/.factory/settings.json的customModels数组中添加模型条目。文件中已有其他模型时,将示例中的对象加入现有数组。language-json{ "customModels": [ { "displayName": "GenStudio DeepSeek Responses", "model": "deepseek-v4.1-flash-1017", "baseUrl": "https://cloud.infini-ai.com/maas/v1", "apiKey": "${GENSTUDIO_API_KEY}", "provider": "openai" } ] }provider: "openai"让 Droid 使用 Responses 接口。填写 GenStudio 通用 LLM API 的 OpenAI 兼容 Base URL,Droid 会自动追加/responses。
注意
使用 GPT 系列模型
为支持 Responses 的 GPT 系列模型添加单独的 customModels 条目,保留 "provider": "openai",并更新 model 和 displayName。如需设置 maxContextLimit 或 maxOutputTokens,请按所选模型的上下文和输出限制填写。首次使用可保留默认推理设置,有需要时再选择该模型支持的推理强度。
选择模型并启动
进入您的项目目录并启动 Droid:
language-shellcd /path/to/your/project droid在 Droid 界面中输入
/model命令。在 Custom Models 下按
displayName选择您配置的模型。
现在,您就可以使用 GenStudio 的模型服务来驱动 Droid 进行编程了。