三步自查
五个真实报障客户里,五个都卡在同样三件事上,没有一个是服务端故障。先过这三步,大概率当场解决。
我们统计了最近 24 小时客户实际撞到的错误:
| 报错 | 受影响客户 | 真正的原因 |
|---|---|---|
模型不存在 | 34 人 | 模型名写错,或模型没在你买的套餐里 |
请求过于频繁 | 27 人 | 触发限流,需要退避重试 |
无权限 | 19 人 | key 挂的套餐与要用的模型不匹配 |
参数错误 | 13 人 | 请求体字段或地址填法不对 |
这四类加起来占了几乎全部工单,而且全都是客户端配置问题,不是服务故障。 这份文档就是按这个顺序写的——先让你跑通,再告诉你出错时去哪查。
济川 AI 同时兼容三套主流协议,用你手上客户端原本支持的那一套即可,不需要改代码:
| 协议 | 地址 | 谁在用 |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | OpenAI SDK、Trae、WorkBuddy、CherryStudio |
| Anthropic Messages | /v1/messages | Claude Code |
| OpenAI Responses | /v1/responses | Codex、Codex Desktop |