Droid 自定义模型接入:customModels 与协议选择
依据 Factory Droid 官方 BYOK 文档,介绍 settings.json 的 customModels、不同协议 provider、模型选择及旧配置排障,不宣称本站已联通。
内容复核中 官方配置已核对;本站接入未实测。 图解为本站原创示意,不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
Droid 的自定义模型配置主要面向 CLI 和读取本地设置的桌面应用,不会自动出现在 Factory 托管的网页或移动端。官方说明 BYOK 密钥保持在本地;这不等于提示词和代码不会发送给你选择的模型供应商。
provider 决定实际协议
官方将 generic-chat-completion-api 对应到 Chat Completions,openai 对应到 Responses,anthropic 对应到 Messages。一个宣称兼容 OpenAI 的聊天接口,不一定能接受 Responses,因此不能把 openai 当成所有兼容服务的通用选择。
增补 customModels,不覆盖已有设置
官方入口是 ~/.factory/settings.json 中的 customModels 数组。以下片段仅展示聊天补全配置,地址是占位,本站没有提供真实接口。密钥和模型 ID 都不是可用凭证。
{
"customModels": [{
"model": "YOUR_MODEL_ID",
"displayName": "示例模型",
"baseUrl": "https://80321.cn/v1",
"apiKey": "YOUR_API_KEY",
"provider": "generic-chat-completion-api"
}]
}
真实配置建议将密钥改为官方支持的 ${VAR_NAME} 环境变量引用,并通过受控方式提供变量。输出上限、图片支持和附加参数只按服务确认的能力设置;不要将另一种协议的字段一起搬入。
从 Custom models 分组验证
在 CLI 使用 /model,到 Custom models 分组选择刚才设置的显示名称。 先发送一条不含代码、不触发工具的短问题,确认实际模型及响应。随后在隔离目录允许一次读取文件操作,观察是否完成工具调用与后续回答。本文没有执行这些操作,也没有验证示例服务。
新旧文件共存时怎么排查
模型不出现,先检查 JSON 语法、必填字段和 provider 拼写。官方说明设置会被监测更新;旧 config.json 的蛇形字段仍兼容,但 settings.json 优先,而且旧文件不支持相同的密钥环境变量展开。
出现鉴权错误时核对服务地址、凭证权限及变量是否提供给启动进程。模型能聊天却不能执行任务时,回到工具调用与流式协议检查,别直接提高输出限制反复重试。
自定义模型仍需独立评估
Factory 没有承诺所有自定义模型开箱即用,兼容供应商的缓存行为也不能保证。 初次验证不要把 /cost 中的估算当成真实供应商账单,更不能预先宣传缓存命中。涉及企业策略时先确认自定义地址是否被允许;动态取钥命令只应来自组织受控设置,不从项目仓库接受陌生脚本。无法确认协议或安全授权时停止接入,而不是绕过组织限制。