model not exist / model not found 怎么解决？模型名排查
直接答案：这通常不是网络问题。依次检查模型名是否准确、接口协议是否匹配、API Key 所属分组是否开放该模型，以及是否误把客户端显示后缀当成模型名。
📌
先看模型名。模型名必须按控制台和文档显示填写，比如
gpt-5.5、claude-opus-4-8、claude-sonnet-4-6。不要把客户端界面里的说明文字一起复制进去。最常见的 5 个原因
- 模型名写错：多了空格、大小写不一致、复制了中文标点，都会导致路由不到模型。
- 把显示后缀当成模型名：例如某些客户端会显示
[1m]这类上下文提示，它不一定是上游真实模型名。 - 协议填错：OpenAI Compatible 走
https://api.apikl.ai/v1；Claude Code 走https://api.apikl.ai。 - 账号分组未开该模型：你的 Key 所在分组可能只开放部分模型，换模型前先看控制台模型列表。
- 客户端缓存旧配置：桌面软件改完服务商后，最好完全退出再打开。
推荐模型名
| 用途 | 模型示例 | 适合场景 |
|---|---|---|
| Codex / OpenAI 兼容 | gpt-5.5 | 代码、通用推理、自动化任务 |
| Claude 高能力 | claude-opus-4-8 | 复杂代码、长文档、深度分析 |
| Claude 均衡 | claude-sonnet-4-6 | 日常 Claude Code、长上下文开发 |
快速修复模板
如果你用的是 Cline、Roo Code、OpenClaw、Hermes 这类 OpenAI 兼容客户端，先按下面改成最稳的组合测试：
OpenAI Compatible
Provider : OpenAI CompatibleBase URL : https://api.apikl.ai/v1API Key : sk-你的密钥Model : gpt-5.5
如果 gpt-5.5 能跑，再换到你想用的 Claude 或其他模型；这样可以先排除 Base URL 和 Key 的问题。
✅
仍然报错时，把完整报错、使用的客户端、Base URL、模型名发给客服即可。注意不要截图泄露完整 API Key。