API 错误处理

API 错误处理:阅读要点

按OmniAI Lab VIP HTTP 状态、错误码和任务状态判断问题,区分鉴权、参数、限流与生成失败。

先读状态和错误码

把 HTTP 状态、结构化错误码、错误消息及任务标识一起记录。鉴权失败、权限不足、参数不支持、余额不足和上游生成失败的处理方式不同,不应统一无限重试。

有任务标识时先查询任务;没有明确受理结果时保留原业务请求和幂等键。不要在用户界面公开完整密钥、认证头或内部服务信息。

可重试不代表可以重复扣发

如果响应明确给出重试或限流信息,按提示等待;修正参数或权限问题后再提交。创建任务的同一次重试仍应遵守幂等规则。

本节给出处理顺序,具体错误码含义以本页的现役错误码表为准。提交问题反馈时提供任务号和脱敏后的错误内容。

HTTP status + error code + task_id
Keep secrets out of public logs.

内容核对: · OmniAI Lab VIP产品文档