ChatBox 接入万模API

适用协议:OpenAI Chat | 适合:轻量跨平台聊天

ChatBox 的配置项较少,适合新手做第一次客户端接入。重点是:API 模式选 OpenAI 兼容,Base URL 填到 /v1,模型名手动填写。

OpenAI 兼容客户端字段示意

开始前确认

项目应该准备什么
客户端已安装 ChatBox
API Key控制台创建的 sk-...
Base URLhttps://www.wanmoapi.com/v1
协议OpenAI Chat
模型名控制台可用模型,例如 gpt-5.4-mini

配置步骤

  1. 打开 ChatBox。
  2. 进入设置。
  3. 找到模型提供方、API 设置或 OpenAI 设置。
  4. API 模式选择 OpenAI API / OpenAI Compatible / 自定义 OpenAI。
  5. API Host / Base URL 填:https://www.wanmoapi.com/v1
  6. API Key 填:你的 sk-...
  7. 在模型列表中添加控制台可用模型名。
  8. 保存并返回对话页。

ChatBox OpenAI Compatible 配置示意

图中重点看三个字段:API Mode 选择 OpenAI Compatible,Base URL 填到 /v1,Model 手动填写控制台可用模型名。示意图中的 API Key 已打码。

字段对照

ChatBox 字段填写内容
API ModeOpenAI API / OpenAI Compatible
API Host / Base URLhttps://www.wanmoapi.com/v1
API Keysk-...
Model控制台可用模型名

验证方式

新建对话并发送:

你好,用一句话介绍你自己。

成功后到控制台调用日志确认:

  • 请求路径是 /v1/chat/completions
  • 状态是成功。
  • 消耗记录符合预期。

常见问题

ChatBox 提示模型不存在

先确认模型名是否手动添加。很多 ChatBox 版本不会自动拉取中转站模型列表。

请求失败但在线调试台成功

说明 Key 和模型基本没问题,重点检查 ChatBox 的 Base URL 是否多写了路径。不要填写 /chat/completions

余额扣了但客户端没显示回复

可能是客户端流式解析失败。先关闭流式输出或换一个模型测试,再查看控制台日志里的原始错误。

下一步:三件套与第一个请求常见问题排查