Droid 安装与 API 配置

要在 Droid 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	从模型广场复制的当前 Model ID

准备工作

• 已安装该工具的当前版本
• BetterToken API Key：注册并获取
• 从模型广场复制的 Model ID

工具特定要求

安装

安装 Droid

macOS / Linux

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

Windows

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

手动配置

你可以在 CLI 中通过 /settings → Custom models 或 /model → Manage custom models 添加模型。桌面应用中打开 Settings → Custom Models。两个编辑器都保存到 ~/.factory/settings.json；下方文件配置是另一种方式。参阅 Factory 自定义模型指南。

字段	填写内容
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	从模型广场复制的当前 Model ID

配置步骤

设置 BetterToken API Key

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

将 YOUR_API_KEY 替换为你的 BetterToken API Key。Droid 支持在 JSON 配置中通过 ${BETTERTOKEN_API_KEY} 读取环境变量。

编辑 Droid 配置文件

配置文件路径：~/.factory/settings.json

{
  "customModels": [
    {
      "displayName": "BetterToken Codex",
      "model": "YOUR_MODEL_ID",
      "baseUrl": "https://bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai"
    }
  ]
}

将 YOUR_MODEL_ID 替换为从模型广场复制的 模型 ID。

启动 Droid 并选择模型

cd /path/to/your/project
droid

在 Droid 中输入 /model，选择刚添加的 BetterToken Codex。Factory 会监听配置文件变化；如果模型列表没有刷新，再退出并重新启动 Droid。

发送测试任务

先发送一个小型任务，例如“解释当前项目的目录结构”。确认 Droid 能返回结果后，再进行跨文件修改或长时间 agent 任务。

将 provider 设为 openai。在 Factory 的 BYOK 配置中，这个值表示使用 OpenAI Responses API；Base URL 使用 https://bettertoken.ai/v1，Model ID 从模型广场复制。要改用 Chat Completions，请将 provider 设为 generic-chat-completion-api，Base URL 保持不变。

在 Droid 0.248.0 的全新配置环境中，未登录 Factory 时，droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" 在两种配置下都成功返回：openai 将请求发送到 /v1/responses，generic-chat-completion-api 将请求发送到 /v1/chat/completions。可使用 droid exec 进行非交互式检查。

References

• Factory BYOK overview

验证连接

发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。

切换模型

打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。

常见错误

现象	检查方法
/model 中没有自定义模型	检查 settings.json 是否为有效 JSON，并确认 model、baseUrl、apiKey、provider 四个字段都存在
Invalid provider	使用小写的准确值 "openai" 或 "generic-chat-completion-api"，不要填写界面展示名称
401 或 403	重新复制 API Key，确认启动 Droid 的终端能读取 BETTERTOKEN_API_KEY，并检查账户余额
404 或 Model not found	Base URL 使用 https://bettertoken.ai/v1；从模型广场重新复制当前 GPT 模型 ID
修改配置后仍显示旧模型	再次打开 /model；如果列表仍未刷新，完全退出并重启 Droid

常见问题

配置模型

将 provider 设为 openai，使用 OpenAI Responses API，Base URL 填写 https://bettertoken.ai/v1；也可设为 generic-chat-completion-api，使用 Chat Completions。 从模型广场复制准确的 Model ID。

需要配置额外 headers 吗？

普通 BetterToken 接入不需要额外 headers。只有你的其他网关明确要求租户、路由或审计 header 时，才按该服务的文档添加。

如何查看模型价格和用量？

模型价格以模型广场实时信息为准。请求用量和余额可在 BetterToken Dashboard 查看。

相关 FAQ

• OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？

• MCP 和 API Key / Base URL 有什么区别？

• Codex CLI 中 model_provider、base_url 和 wire_api 是什么？

• Cline 如何配置 OpenAI-compatible API？

• 对比所有支持的工具

• API 错误、状态码与限流

技术说明

协议、endpoint 与 provider 内部字段

本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。