错误处理

H3 视频任务 API · /api/v3

错误响应

JSON · 参数错误示例

{
  "error": {
    "code": "InvalidParameter",
    "message": "请检查 model、content 及生成参数",
    "request_id": "REQUEST_ID"
  }
}

保存 HTTP 状态、error.code、error.message 与请求 ID。入口或中间件错误码可能不同，不要仅依赖示例字符串判断。

HTTP 状态码

HTTP	含义	建议处理
401	鉴权失败	检查 Bearer Key。
402	准入额度不足	联系管理员调整调用预算，不等于已产生的月结金额。
403	账户 / 模型无权限	核对账户状态和模型授权。
404	任务不存在或已过期	核对账户、ID 和查询协议。
409	幂等 / 状态冲突	核对同键请求是否改变，或任务是否已不可取消。
413	输入过大	减少图片 / 请求大小。
422	参数或图片不支持	核对类型、图片格式与模型规格。
429	限流 / 队列满	遵循 Retry-After，保留幂等键。
500 / 502 / 503	异常 / 暂无容量	退避后重试，同一创建沿用幂等键。

避免重复生成

网络超时不会取消服务端任务。已拿到 ID 就继续查询；创建时未收到 ID，用原幂等键重试同一请求。