错误与排查

DDTokens 是模型 API 网关。错误可能来自 DDTokens 账户系统、网络链路，也可能来自上游模型厂商。先判断错误来源，再决定是否重试。

常见错误类型

类型	常见原因	是否建议重试
鉴权错误	API Key 无效、被禁用、过期或请求头格式错误	不建议，先修正 Key
余额错误	账户余额或令牌额度不足	不建议，先充值或调整额度
限流错误	请求频率超过账户或令牌限制	建议退避后重试
上游错误	上游模型过载、不可用或拒绝请求参数	视错误内容决定
超时错误	请求耗时超过客户端、网络或网关限制	可缩短输出或切换策略后重试

鉴权失败

检查以下项目：

1. 请求头是否为 Authorization: Bearer <API_KEY>。
2. API Key 是否复制完整。
3. API Key 是否属于当前账户。
4. API Key 是否被禁用、删除或超过有效期。

余额不足

余额不足可能来自账户余额，也可能来自单个令牌额度。建议打开控制台检查：

• 账户可用余额。
• 当前令牌的可用额度。
• 最近一次失败请求是否已经产生扣费。

触发限流

如果出现 429 或类似限流错误，客户端应降低并发，并使用指数退避：

1s -> 2s -> 4s -> 8s

不要在短时间内无间隔重试。这样会延长恢复时间，也可能触发更严格的保护策略。

上游错误

上游错误通常和模型厂商、模型参数或临时容量有关。你可以尝试：

• 换用更稳定的模型。
• 移除不确定的参数。
• 降低输出长度。
• 检查是否指定了不可用的模型或厂商前缀。

联系支持前准备

为了快速定位问题，建议提供：

• 请求时间。
• API Key 名称，不要提供完整 Key。
• 模型名。
• HTTP 状态码。
• 错误响应正文。
• 控制台日志里的请求 ID，如果页面提供。