开发者资源

Chatbox AI

安装 Chatbox AI，添加 RunAPI custom provider，获取模型、执行连接检查并验证聊天。

通过 custom BYOK provider 将 Chatbox AI 连接到 RunAPI。下方名称以当前 custom-provider 界面为准，不同 desktop release 的 label 可能略有差异。开始前，请在身份验证指南创建标准 RunAPI API Key。

安装 Chatbox AI

从官方下载页或官方 Releases下载 Chatbox AI，然后打开 Settings。

Host 与 Path 必须分开填写。Fetch 会以 Host 加 /models 进行 model discovery，而 chat 使用 Host 加配置的 API Path。

选择 Fetch 加载 RunAPI model inventory。若自动发现不可用，请选择 New，从模型目录复制并输入准确 identifier。Chatbox AI 至少保存一个 model 后才能运行 Check。

选择 Check 和已保存 model，然后运行连接测试。基础成功标准是 Text Request 成功。Vision Request 与 Tool Use Request 取决于所选 model 的能力；它们单独失败不代表基础文本 chat 连接失败。

新建 chat，在 model selector 中选择保存的 RunAPI model，发送 只回复 connected。。收到正常响应即表示 custom provider 已启用。

URL preview 错误： Host 使用 https://runapi.ai/v1，Path 使用 /chat/completions；不要在两个字段中都填写完整 operation URL。
Check 不可用或没有 model： 先使用 Fetch 或 New 添加至少一个 model。
Text Request 返回身份验证错误： 使用身份验证指南中的有效标准 Key 更新 provider。
Text 可用但 Vision 或 Tool Use 失败： 在模型目录选择声明了所需能力的 model；这些检查不是所有 provider 的基础要求。

通用协议行为请查看 LLM API 快速开始。请求和响应字段请查看 Chat Completions API 参考。