排错兼容性
兼容性排错：401、模型不存在与端点问题
按错误码排查接入问题：鉴权失败、模型 ID 不在目录、端点类型不匹配、余额不足。
· 万川博客
接入报错时，先看错误码，再按下面的清单排查。本文只覆盖万川公开功能范围内的常见问题。
401 Unauthorized / Authentication
- 请求头缺少
Authorization: Bearer <key>，或 Key 复制不完整（注意首尾空格）。 - 环境变量名不对：检查
WANCHUAN_API_KEY是否已正确导出。 - Key 在控制台被删除或停用：登录控制台重新创建。
404 / 模型不存在
- model id 不在当前公开目录中：目录数据来自公开接口，不能保证编造或臆测的 ID 可用。
- 模型存在但账号分组不可用：查看目录中该模型的
enable_groups，你的分组需包含在内。 - 模型名称拼写或大小写不一致（部分 ID 包含日期后缀，如
claude-haiku-4-5-20251001）。
端点不支持 / 协议错误
- 确认模型详情的端点类型：只支持
openai的模型用 Anthropic Messages 协议调用会失败。 - Anthropic 风格请求需带
x-api-key与anthropic-version头；Gemini 风格客户端请选择标注gemini端点的模型。 - 请勿混用 SDK 与协议：OpenAI SDK 走
/v1/chat/completions，不要手动拼到其他路径。
余额不足
- 在控制台充值后再调用；按量模型按 token 扣费，长输出会更快消耗余额。
- 以控制台账单记录为准，本站展示的价格是同步快照，可能与最新目录有短暂差异。