Appearance
ChatBox 配置
ChatBox 的关键点不是“统一填一个 URL”,而是先看模型更适合 Claude 兼容入口还是 OpenAI 兼容入口。Claude、Kimi、GLM、MiniMax、DeepSeek、Qwen 这类模型,优先按 Claude / Claude Code 兼容方式填根域名。
准备信息
| 项目 | 值 |
|---|---|
| API Key | sk-YOUR_TOKEN |
| Claude / Claude Code 兼容地址 | https://zrapi.org |
| OpenAI SDK 兼容地址 | https://zrapi.org/v1 |
| 模型列表 | 模型与价格 |
方式一:Claude API / Claude Code 兼容
适合 Claude、Kimi、GLM、MiniMax、DeepSeek、Qwen 等模型。模型名建议直接从 模型与价格 复制,避免大小写、横线或斜杠写错。
| ChatBox 字段 | 建议填写 |
|---|---|
| AI Provider / 提供商 | Claude API 或 Anthropic API |
| API Key | sk-YOUR_TOKEN |
| API Host / Base URL | https://zrapi.org |
| Model / 模型 | 例如 claude-opus-4-7,国产模型请从模型页复制 |
TIP
OpenAI 兼容地址 https://zrapi.org/v1 主要给 OpenAI SDK、后端代码或明确要求 OpenAI Base URL 的工具使用。ChatBox 里如果你选的是 Claude / Anthropic 模式,Base URL 填 https://zrapi.org。
方式二:OpenAI API
适合 GPT / OpenAI SDK 兼容用法。
| ChatBox 字段 | 建议填写 |
|---|---|
| AI Provider / 提供商 | OpenAI API |
| API Key | sk-YOUR_TOKEN |
| API Host / API 域名 | https://zrapi.org |
| Base URL / 自定义接口地址 | https://zrapi.org/v1 |
| Model / 模型 | 例如 GPT-5.5 |
WARNING
如果 ChatBox 字段名是 API Host 或 API 域名,通常填根域名 https://zrapi.org,让客户端自己拼接路径。如果字段名明确是 Base URL 或要求填写 OpenAI SDK 地址,再填 https://zrapi.org/v1。
如何验证
- 保存设置。
- 新建对话,发送
请回复 OK。 - 如果返回正常文本,说明配置完成。
- 如果报错,按下面表格排查。
| 报错 | 优先检查 |
|---|---|
| 401 | Key 是否完整、是否多了空格 |
| 402 | 控制台余额是否足够 |
| 404 | Host 是否被重复拼接 /v1,模型 ID 是否正确 |
| 429 | 请求过快,稍后重试 |