错误与重试

Enodot 会尽量保持各协议原生错误格式。用户排查时重点看 HTTP 状态码、错误 JSON、模型名和 request id。

常见 HTTP 状态

状态	含义	用户处理
400	请求格式错误	检查 JSON、模型名、必填字段和端点协议。
401	API Key 无效	重新复制 Key，确认请求头格式。
403	余额、订阅、权限或 IP 限制不满足	查看余额、订阅、Key 状态和当前网络。
404	当前协议或能力不支持	检查 Base URL、端点和模型。
413	请求体过大	减少上下文、文件或图片体积。
429	Key、用户或服务额度触发	等待窗口重置，或换一个自己可用的模型。
502	上游请求失败	稍后重试；持续出现时带 request id 联系支持。
503	服务暂不可用	稍后重试；持续出现时联系支持。

重试建议

建议只对临时错误做有限重试：

• 可重试：429、502、503、连接断开、流式中断。
• 不建议重试：400、401、明显余额不足的 403。
• 重试间隔建议：1s、2s、4s、8s。
• 流式请求失败后，重新发起一次完整请求，不要把两次输出手动拼在一起。

提交问题需要的信息

请尽量提供：

• 请求时间和时区。
• 端点路径。
• 模型名。
• request id。
• API Key 名称或末尾 4 位。
• 错误状态码和错误 JSON。
• 是否流式请求。