API 错误处理
API 错误处理:阅读要点
按OmniAI Lab VIP HTTP 状态、错误码和任务状态判断问题,区分鉴权、参数、限流与生成失败。
先读状态和错误码
把 HTTP 状态、结构化错误码、错误消息及任务标识一起记录。鉴权失败、权限不足、参数不支持、余额不足和上游生成失败的处理方式不同,不应统一无限重试。
有任务标识时先查询任务;没有明确受理结果时保留原业务请求和幂等键。不要在用户界面公开完整密钥、认证头或内部服务信息。
可重试不代表可以重复扣发
如果响应明确给出重试或限流信息,按提示等待;修正参数或权限问题后再提交。创建任务的同一次重试仍应遵守幂等规则。
本节给出处理顺序,具体错误码含义以本页的现役错误码表为准。提交问题反馈时提供任务号和脱敏后的错误内容。
HTTP status + error code + task_id
Keep secrets out of public logs.内容核对: · OmniAI Lab VIP产品文档