error.message;视频异步接口也可能使用顶层 code、message、data 结构。具体以该接口的响应定义为准,不要仅凭 HTTP 200 判断任务已生成成功。| HTTP 状态码 | 常见含义 | 建议处理 |
|---|---|---|
400 | 参数、格式或模型能力不匹配 | 检查接口路径、字段类型和目标模型能力 |
401 | API Key 缺失、无效或已过期 | 检查 Bearer 鉴权头与密钥状态 |
403 | 权限受限,或请求预扣额度不足 | 结合错误消息检查账户分组、密钥限制、余额及预扣要求 |
404 | 接口、模型、任务或结果资源不存在 | 检查路径、模型 ID、任务 ID 及对应账户权限 |
429 | 频率或并发限制,也可能是额度相关错误 | 根据错误消息区分限流与额度问题;额度不足应先处理余额 |
500 | 平台或任务处理异常 | 保存响应信息,按请求是否可能已受理决定后续处理 |
502 | 上游暂时不可用或返回异常 | 保存响应信息;查询请求可以有限重试,提交请求先判断是否已受理 |
code、message、data 的响应时,应按具体接口说明判断业务状态;message 用于排查原因,任务和结果字段可能位于 data 中。不要把通用对话接口的 choices 解析逻辑用于视频任务。403 且消息明确指出预扣额度不足,请检查账户与 API Key 可用额度。预扣校验未通过不能通过重复提交解决;具体计费与结算规则以平台控制台和视频接口说明为准。Retry-After,优先遵循该提示。达到客户端设定的查询截止时间后停止轮询并保存任务 ID。service@zhuanqicloud.com、zhuanqicloud@gmail.com。