FAQ

这里收集接入 ZR API 时最常见的问题。找不到答案时，请带上截图到用户群里提问。

连接与配置

OpenAI SDK 的 Base URL 填什么？

填：

https://zrapi.org/v1

Claude SDK 的 Base URL 填什么？

填：

https://zrapi.org

Claude SDK 通常会自己拼接 /v1/messages。

ChatBox 里到底填不填 /v1？

看字段名：

字段名	通常填写
API Host / API 域名	https://zrapi.org
Base URL / OpenAI SDK 地址	https://zrapi.org/v1

如果报 404，很可能是客户端重复拼接了 /v1。

账户与余额

402 是什么意思？

余额不足。进入 控制台 查看余额，或前往 获取兑换码 充值。

Key 泄露了怎么办？

立即在控制台删除旧 Key，并创建新的 Key。不要尝试继续使用泄露的 Key。

模型选择

我该先试哪个模型？

场景	建议
第一次接入	GPT-5.5 或成本更低的国产模型
中文总结和批量任务	DeepSeek-V4-Flash、Kimi-K2.6、GLM5.1
长文和复杂分析	Claude 系列
图片	gpt-image-2

Kimi、GLM、MiniMax、DeepSeek、Qwen 怎么配置？

在 ChatBox、Claude Code、Codex 等客户端里，这些模型通常按 Claude Code 兼容方式配置：

字段	值
API Key	sk-YOUR_TOKEN
Base URL	https://zrapi.org
Model	从 模型与价格 复制对应模型 ID

为什么模型名明明复制了还是 404？

常见原因：

• 大小写、横线或斜杠不一致。
• 使用了尚未开放或已下线的模型。
• 把 Claude 或国产模型填到了只支持 OpenAI 模式的客户端里。

成本与稳定性

如何降低成本？

优先选择国产模型做批量任务；把复杂推理、长文本分析交给更强模型；同时设置合理的 max_tokens，避免输出过长。

500 / 502 是否一定是我的配置错了？

不一定。500 / 502 更多时候是服务端或上游模型临时异常。可以稍后重试、换模型，或者到用户群里反馈。

快速开始错误码排查加入用户群