错误排查指南

先做四项检查

1. Base URL 是否为当前站点 /v1
2. API Key 是否来自当前账户且未轮换
3. 套餐是否有效、当前周期是否有额度
4. 模型是否仍在实时目录中

按状态码处理

状态	常见原因	处理
400	请求体、模型或协议不匹配	用最小 cURL 示例对比
401	密钥缺失、错误或已轮换	重新复制密钥并更新客户端
403	账户、地址、套餐或策略限制	登录控制台检查账户状态
404	Base URL/路径错误或模型不存在	确认 /v1/responses 或 /v1/chat/completions
429	额度或速率限制	检查周期额度，退避后有限重试
5xx	网关或上游异常	保存时间和请求 ID，稍后重试

客户端没有请求记录

请求通常未到达 DmCodex。检查 DNS、代理、Base URL、环境变量和客户端是否仍在使用官方 provider。

有失败记录

请求已到达网关。对照记录时间、模型与费用，再检查请求体、模型路由、额度或上游错误。

收集问题信息

提供发生时间、客户端及版本、操作系统、接口路径、模型、HTTP 状态和遮罩后的请求 ID。不要提供完整 API Key、兑换码或收款码。