故障排查

本页按现象整理常见问题。排查时，先确认 API Key、Base URL、模型名和账户余额。

认证失败

常见原因：

• API Key 复制不完整。
• 请求头缺少 Bearer。
• 当前终端没有读取到环境变量。
• 令牌已禁用、删除或过期。

检查命令：

echo "$DDDT_BASE_URL"
echo "$DDDT_API_KEY"

不要把完整 API Key 发给他人。

余额或额度不足

如果请求提示余额不足，检查：

• 账户余额。
• 当前令牌额度。
• 是否有异常脚本持续调用。
• 最近日志里的费用变化。

必要时，先禁用可疑令牌。

模型不可用

模型不可用通常由模型名错误、账户权限不足或上游资源不可用导致。

处理方式：

1. 在控制台确认模型名。
2. 换用轻量模型验证连接。
3. 如果指定了渠道前缀，先改回默认模型名。
4. 查看日志里的实际错误。

请求被限流

如果出现 429 或类似错误：

1. 降低并发。
2. 增加请求队列。
3. 使用指数退避重试。
4. 检查账户等级和令牌限制。

请求超时

超时可能来自客户端、网络、网关或上游模型。你可以：

• 缩短 prompt。
• 降低最大输出长度。
• 换用更快模型。
• 对流式输出设置更长超时。
• 记录请求时间和错误响应，联系支持。

费用异常

先查看调用日志，确认：

• 是否调用了高价模型。
• 输出 Token 是否异常偏高。
• 是否有测试脚本重复调用。
• 是否有未使用的令牌泄露。

发现异常时，先禁用相关令牌，再继续排查。