Chatbox 接入

Chatbox 接入牛API时，需要确认 API 模式、API Host、API Key 和模型 ID。Responses 纯文本已有成功示例；Chat Completions、流式、图片和工具能力请按下方顺序单独测试。

实测 ProviderCustom Provider

API Hosthttps://api.reniuniu.win

Responses 纯文本已通过

Chat Completions配置后测试

先看清接口预览

使用 OpenAI Responses API Compatible 时，预览地址应以 /v1/responses 结尾；使用内置 OpenAI Provider 时，预览地址通常以 /v1/chat/completions 结尾。两种路径都只填写 Host https://api.reniuniu.win，不要再手动追加 /v1。

开始前准备

1. 在牛API控制台创建一个只给 Chatbox 使用的 Key；
2. 确认 Key 所属分组能够调用目标模型；
3. 从控制台复制模型 ID，大小写必须完全一致。

推荐顺序是 Key → 分组 → 模型 → 测试。模型不可用时，先检查 Key 分组，不要连续更换地址试错。

第一步：选择接入路径

Responses API 路径使用 Settings → Model Provider → Add Custom Provider，配置如下：

字段	填写内容
Provider Name	niuapi（名称可自定义）
API Mode	OpenAI Responses API Compatible
API Key	牛API控制台创建的专用 Key
API Host	https://api.reniuniu.win

保存前确认界面预览为 https://api.reniuniu.win/v1/responses。

若使用 Chatbox 内置的 OpenAI Provider，则进入 Settings → Model Provider → OpenAI。

内置 OpenAI Provider 的字段填写为：

字段	填写内容
API Key	牛API控制台创建的专用 Key
API Host	https://api.reniuniu.win

Chatbox 的 OpenAI Provider 设置。API Host 只填写根地址，Key 请使用牛API专用 Key。

确认 API Host 下方的预览地址以 /v1/chat/completions 结尾。若出现两个 /v1，说明 Host 多填了一层路径。保存后先用最小消息验证连接。

第二步：添加模型

在 Model 区域点击 New，至少填写：

• Model ID：从牛API控制台复制；
• Nickname：可填 牛API模型，只用于本地识别；
• Model Type：保持 Chat。

Vision、Reasoning、Tool use 先不要勾选。基础聊天通过后，再按模型能力逐项开启。

真实“Edit Model”弹窗。`YOUR_MODEL_ID` 必须替换为控制台中的模型 ID。

点击 Save 保存模型。不要点击 Fetch 猜测模型列表；当前牛API公开模型接口需要认证，直接使用控制台中的真实 ID 更可靠。

第三步：发送最小测试

新建一个空白会话，关闭联网、工具和图片功能，发送：

只回复：牛API连接成功

客户端侧满足下面三项，可以确认纯文本基础调用已完成：

1. Chatbox 收到预期的文本回复；
2. 回复下方显示刚才配置的 Provider 和模型 ID；
3. Chatbox 未显示认证、模型或网络错误。

如需核对计费，再到牛API控制台确认请求记录、模型 ID 和用量。账单信息以控制台记录为准。

Responses API 连接示例

Chatbox 通过 Responses API 返回预期文本。截图不包含 Key；界面中的 Token 数仅供本次会话参考，实际用量与费用以控制台为准。

当前能力说明：

能力	状态	说明
Responses API 纯文本基础调用	已验证	Chatbox 已返回预期文本，并显示本次配置的 Provider 与模型
Chat Completions	配置后测试	使用 /v1/chat/completions 发送最小消息
流式输出	按模型确认	基础文本成功后单独开启
图片理解	按模型确认	只使用控制台标明支持图片的模型
工具调用	按模型确认	在无敏感信息的会话中测试单个低风险工具

基础调用通过后，再分别测试流式输出、图片理解和工具调用。不要一次把所有能力都打开，否则出错时无法定位是哪一项不兼容。

出错时按状态码处理

现象	先检查什么
401	Key 是否完整、是否有首尾空格；不要手动添加 Bearer
404	API Host 是否误填成带 /v1 的地址；模型 ID 是否正确
模型不可用	Key 分组、模型权限和当前渠道状态
429	关闭并行请求，等待后以并发 1 重试
流式中断	先关闭流式，确认普通文本请求能否完成

更多错误见常见问题。

Key 安全

不要把完整 Key 放进截图、聊天记录或云同步配置。若 Key 曾泄露，立即在控制台撤销并重建。