错误码与故障排查
按 HTTP 状态和 error.type 定位鉴权、预算、频率、配置及待对账问题，提供脱敏报障与付费请求重试原则。
作者：德他数据技术团队 · 更新于 2026-09-24
核心解答
先记录状态码、error.type、发生时间和请求编号，再区分参数错误、权限不足、限流或结果不明。502/超时不证明未计费，503 安全锁表示能力未开放；不要通过反复重试绕过核准流程。
常见状态
| 状态 | 常见错误 | 处理方式 |
| --- | --- | --- |
| 400 | unsupported_request / invalid_request | 检查字段、纯文本消息及输出上限 |
| 401 | invalid_api_key | 检查 Bearer 令牌、启用状态与所属账户 |
| 403 | ip_not_allowed / billing_not_ready | 检查 IP、模型范围、余额、预算与调用核准 |
| 409 | configuration_changed | 联系管理员重新核准配置 |
| 429 | busy / rate_limit_exceeded | 降低并发，按 Retry-After（若返回）等待 |
| 502 | reconciliation_required | 先核验账务与结果，不自动重试 |
| 503 | deta_release_safety_lock | 当前能力未开放，换域名或重试不能解锁 |
记录哪些信息
{
"error": {
"type": "reconciliation_required",
"message": "示意：结果尚未确认，请联系支持核验"
}
}
保留时间、模型、状态码、error.type 和 X-Deta-Request-ID。请求体和密钥需脱敏。
失败响应的具体 message 以实际结果为准，示例不是固定文案。
重试边界
网络超时并不证明上游没有生成或计费。先确认前次结果，再决定是否发送新请求。
当前没有自动故障切换或对客户端重试请求的去重承诺。
联系 support@data123.com.cn 时不要附带真实 API 令牌。
常见问题
遇到 502 可以自动重发吗？
不应直接重发。先通过请求编号核验前次结果及预留金额，确认处理结论后再决定是否发起新请求。
接下来阅读
关联文档：德他数据教程。本文按德他实际功能独立编写。