常见错误排查 · Weason 文档

发生错误时，先记录状态码、完整错误消息和发生时间。不要把所有故障都归因于 Key；模型、端点、参数和上游也会影响结果。

按状态码定位

实际错误含义以错误体为准。额度不足可能使用不同状态码，不应只凭 429 或 403 判断。

场景	正确地址
OpenAI / Codex Base URL	`https://weason.cn/v1`
Claude Code Base URL	`https://weason.cn`
画布 Weason API Base URL	`https://weason.cn`
完整 Chat 请求 URL	`https://weason.cn/v1/chat/completions`
完整 Messages 请求 URL	`https://weason.cn/v1/messages`

若得到 HTML 登录页而不是 JSON 错误，通常是请求落到了网页路由。检查最终 URL，而不是继续更换 Key。

临时设置只影响当前终端及子进程。桌面应用、另一终端和重启后的进程可能没有这些变量。只检查变量是否存在，不要把完整 Key 打印出来截图。

CC Switch、本地代理、配置 Profile 或旧工具设置也可能覆盖地址。先确认实际请求发往哪里，再改配置。

模型名称须与返回的 ID 完全一致。检查 Key 分组、模型限制和目标协议。模型出现在列表中仍可能没有健康上游，改用已确认兼容的其他模型可帮助定位。

提交发生时间与时区、模型、分组、客户端版本、HTTP 状态码、脱敏错误体及请求 ID（如有）。隐藏 Key、Cookie、私人提示词与支付敏感信息。联系支持。