自定义 API（Bring Your Own Key）

自定义 API，指的是使用你自己的模型服务地址、密钥和模型列表，把外部模型接入火狐AI 后使用。

适合谁，不适合谁？

更适合：

• 已经有自己的 API Key
• 想指定某个特定提供商或渠道
• 想继续使用原来的账单、额度和模型来源

不太适合：

• 第一次接触火狐AI 的新手
• 不清楚 Base URL、模型 ID、上下文长度是什么的人
• 不想自己处理余额、权限、协议和上游报错的人

如果你只是想先开始聊天，通常更建议先用 官方模型。

为什么选择自定义接入？

• 自主掌控：无论是接入高性价比渠道还是内部模型，都能灵活配置和切换
• 多协议兼容：兼容 OpenAI、Anthropic、Google 原生协议，以及国内主流模型
• 网络代理：提供中转代理；如果你要接入海外模型，无需额外折腾复杂网络环境
• 完整功能支持：接入后可继续使用平台完整功能，并提供消息级 Token 统计明细

接入前，先准备这 4 项

接入前，请先从提供商控制台拿到以下四项信息：

关键字段	说明	避坑指南
Base URL	接口地址，如 https://api.openai.com/v1	记得核对是否需要后缀 /v1
API Key	你的身份校验密钥	请勿泄露，平台会进行企业级加密存储
模型名称	具体模型 ID，如 deepseek-chat	必须与上游文档定义的 ID 完全一致
上下文长度	该模型支持的最大 Token 数量	不要超过模型支持的真实上限

接入流程

第一步：新增配置

在“我的 API”页面点击“新增”，再选择对应的提供商类型。

这一步决定了平台使用哪种请求协议。

第二步：配置接口

输入你的 Base URL 和 API Key。

• 获取模型：如果提供商支持标准列表接口，点击此按钮可自动抓取所有可用模型
• 手动录入：如果无法自动获取，请手动输入准确的模型 ID

第三步：验证与保存

点击“验证 API”测试连通性。出现成功提示后，再点击保存。

第四步：聊天页切换

保存完成后，你就可以像使用平台模型一样，在聊天页切换到自己的 API 并开始对话。

常见排查指南

1. 为什么“获取模型”失败？

• 接口限制：部分提供商或中转服务不开放 /models 列表接口，这种情况下手动填写模型名即可
• URL 错误：检查 Base URL 是否多写或少写了斜杠、版本号
• Key 权限：确认你的 Key 是否创建正确，状态是否正常

2. 模型名对了，但验证失败？

• 协议不匹配：例如把 GPT 模型选成了 Anthropic 协议类型
• 提供商不支持非流：验证 API 时使用的是非流式请求。保存 API 后，可在对话中开启流式输出再测试

3. 出现类似 [1, 8192] 的错误？

• 上下文配置错误：请核对上游文档，确保填写的“上下文长度”小于或等于模型真实限制

4. 出错了，该先找谁？

如果你使用的是自己的渠道或 Key，优先排查顺序通常是：

1. 先检查你自己的 Base URL、Key、模型 ID
2. 再确认上游账户状态、权限和余额
3. 最后再区分是不是平台转发或兼容问题

隐私与安全说明

提示

• 密钥加密：所有密钥均通过 AES-256 加密存储
• 隔离原则：平台只做转发服务，不涉及任何中转费用
• 错误处理：如遇错误或服务异常，请联系你的渠道商反馈
• 服务可用性：API 的稳定性和可用性由你的渠道商提供