Factory Droid 接入 ModelFold

首次会话积分消耗偏高属正常现象

Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。

全部编程工具 · 更多工具接入 · 不支持与受限工具

Factory Droid 1.7.1：CLI 最小对话返回 OK（gpt-6-luna，generic-chat-completion-api）。配置入口支持不等于每个模型、每项 Agent 功能都已验证。

安装与准备

通过官方文档中的安装入口安装正式版本；编辑器插件请在对应商店选择官方发布者。到 ModelFold API Keys 创建密钥。配置中出现 MODELFOLD_API_KEY 时，启动工具前设置环境变量：

bash

export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"

密钥不要提交到项目仓库或贴到截图中。图形界面密钥框通常填写原始 Key，由客户端添加认证头。

配置提供商

配置位置： ~/.factory/settings.json。验证状态： Factory Droid 1.7.1：CLI 最小对话返回 OK（gpt-6-luna，generic-chat-completion-api）。

从 Factory 官方安装页安装 Droid。把条目合并到 customModels，在 /model 中选择自定义模型。支持 --settings 文件做进程级验证。

json

{
  "customModels": [
    {
      "model": "gpt-6-luna",
      "displayName": "ModelFold Test",
      "baseUrl": "https://modelfold.ai/v1",
      "apiKey": "${MODELFOLD_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 1024
    }
  ]
}

Chat Completions 必须选 generic-chat-completion-api；不要把 openai 当作兼容协议。Claude 推荐 provider=anthropic、baseUrl=https://modelfold.ai/anthropic。

接 Claude 优先使用 Anthropic 原生格式，符合条件的重复上下文可使用缓存；命中仍取决于模型、前缀和客户端是否发送缓存标记，不能保证每轮都命中。

官方配置依据。

模型与地址

字段	填写内容
本页示例地址	`https://modelfold.ai/v1`
API 模型 ID	`gpt-6-luna`
凭证	ModelFold 控制台创建的 API Key

模型 ID 以全部模型 ID为准。openai/ 等前缀在部分 CLI 中用来选择适配器，不属于服务端模型 ID。不同工具拼接路径的规则不同，严格按本页填写，不重复添加 /v1 或 /messages。

验证

新建会话，明确选中刚配置的提供商与模型，发送：只回复 OK，不要使用工具。 收到回复只证明该模型的基本对话可用。再到 ModelFold 用量记录核对相应请求；模型出现在列表里不代表连通性验证通过。开始长任务前，可在临时项目中试一次小修改。

常见问题

现象	处理
401	检查是否为 ModelFold Key，而非工具订阅凭证；去掉首尾空格。
404	核对协议、路径后缀与准确模型 ID，避免重复 `/v1`。
模型列表为空	支持手动输入的工具可复制准确 ID；环境变量修改后重启客户端。
对话通但工具调用失败	选择支持工具调用的模型；基本聊天兼容不保证全部 Agent 功能。
仍然调用内置服务	显式切换到自定义提供商，检查旧设置和环境变量覆盖。

报价以模型价格页为准。一次任务可能产生多次请求；实际扣费以账户记录为准，客户端估算不等于实际扣费。

Factory Droid 接入 ModelFold ​

安装与准备 ​

配置提供商 ​

模型与地址 ​

验证 ​

常见问题 ​

Factory Droid 接入 ModelFold

安装与准备

配置提供商

模型与地址

验证

常见问题