Chatbox API 接入指南
在 Chatbox 中通过 OpenAI 兼容提供方配置 UniRoute 的 API 主机、API 路径、密钥与模型。
Chatbox 接入 · 按量 API
添加 UniRoute 提供方，API 模式选择「OpenAI API 兼容」。分别填写主机和请求路径，添加模型后开始对话。
适合：使用 Chatbox 进行日常对话、写作与代码问答的用户。
快速配置
登录后可一键创建 Key 并自动填入 登录
按字段复制并粘贴到客户端设置中。
API 模式
OpenAI API 兼容API 主机
https://api.uniroute.app/v1API 密钥
YOUR_UNIROUTE_API_KEYAPI 路径
/chat/completions名称
UniRoute模型ID
deepseek-v4-flash配置步骤
1. 添加兼容提供方
打开 设置 → 模型提供方 → 添加，将 名称 填为 UniRoute，API 模式 选为 OpenAI API 兼容，点击 添加。
2. 填写主机、路径与密钥
按快速配置填写 API 密钥、API 主机 与 API 路径。检查预览地址，应为 https://api.uniroute.app/v1/chat/completions。首次连接保持 改善网络兼容性 关闭。
3. 添加聊天模型
在 模型 区域点击 新建，将 模型ID 填为 deepseek-v4-flash，保存。也可以点击 获取，从返回列表选择模型。
按所需功能设置模型能力；未设置能力时按纯文本模型处理。
4. 检查并选择模型
点击 检查，回到对话窗口，选择 UniRoute 下的模型。
Chatbox AI 托管模型和搜索服务与 UniRoute 提供方分别配置。
这几个变量分别做什么
| 字段 | 用途 |
|---|---|
| API 模式 | OpenAI API 兼容使用 Chat Completions 协议。 |
| API 主机 | 服务地址，包含末尾的 /v1。 |
| API 路径 | 与主机拼接的 /chat/completions 路径；/v1 只保留在主机中。 |
| API 密钥 | 用于 UniRoute Bearer 请求认证。 |
| 模型ID | 请求中使用的精确模型标识。 |
| 改善网络兼容性 | 可选的连接设置，首次配置保持关闭。 |
选择模型
怎么确认已经切过来了
发送一句测试：请只回复：你好
打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。
点击 检查，再用 UniRoute 模型新建对话。查看流式回复，并在用量日志核对模型。
切回原配置 / 恢复备份
在对话窗口选回原提供方的模型。不再需要此连接时，在模型提供方设置中只删除 UniRoute 提供方。
还没安装？
从 Chatbox 官方下载页 安装客户端，再打开 设置 → 模型提供方。
常见问题
API 路径需要加 /v1 吗？
API 主机为 https://api.uniroute.app/v1 时，路径填写 /chat/completions。预览会显示完整地址。
可以自动获取模型列表吗？
可以。「获取」携带你的密钥访问当前主机的 /models 接口，再从返回结果中选择添加。
这套提供方配置可以使用 Claude 吗？
可以。选择上面的 Claude Sonnet 模型并保留 OpenAI API 兼容；UniRoute 为该模型提供 Chat Completions 协议。
这个连接可以生成图片吗？
自定义 OpenAI 适配器提供文字聊天模型，不添加图片生成模型。
常见错误
404 / 重复的 /v1
主机与路径重复包含版本或接口。
API 主机填 https://api.uniroute.app/v1，API 路径填 /chat/completions。
401 / 密钥无效
Key 不完整、已撤销或缺少权限。
在 API 密钥中粘贴完整有效的 UniRoute Key。
对话中找不到模型
提供方模型列表为空。
点击新建填写模型ID，或从获取结果中选择模型。
Chatbox AI 搜索要求许可证
所选搜索服务使用自己的许可证。
在 Chatbox 中单独选择并配置搜索提供方。
参考资料
Chatbox 模型配置 · 使用自己的 API Key · 主机与路径处理
相关链接
全部集成 · 管理 API Key · 协议与地址 · 模型价格 · 用量记录