文档

错误码

更新于 2026-10-21

状态码	场景	建议
400	参数非法	检查 JSON 字段与模型限制
401	鉴权失败	检查 API Key
403	权限不足	检查分组、余额或模块开关
404	路由不存在	检查路径与模型名
429	限流	降低并发并指数退避
5xx	上游或网关异常	稍后重试并查看状态页/日志

错误响应通常包含可读的 message 字段。媒体任务的参数错误还会提供稳定的 code、出错字段 data.field 和修正动作 data.action；客户端应优先使用这些结构化字段，不要依赖英文文案匹配。

媒体任务可修正错误

错误码	字段	修正动作	客户端处理
`prompt_required`	`prompt`	`enter_prompt`	聚焦提示词输入框，禁止空值提交
`invalid_mode`	`mode`	`select_mode`	使用 `data.allowed_values` 重新选择
`invalid_generation_type`	`generation_type`	`select_generation_type`	选择服务端返回的标准生成方式
`style_too_long`	`style`	`shorten_style`	将风格描述缩短到 `data.max_length` 个字符以内
`reference_image_required`	`image` / `image_start`	`reupload_reference_image`	返回上传步骤并等待上传完成
`reference_image_unavailable`	`image`	`reupload_reference_image`	删除失效引用并重新上传
`invalid_reference_image_count`	`image_start`	`select_single_starting_image`	图生视频只保留一张起始图片

这些错误使用 HTTP 400，data.submission_state 为 rejected，data.charge_status 为 not_charged。修正输入后应使用新的幂等键提交；不要对同一无效请求执行自动重试。

{
  "code": "invalid_reference_image_count",
  "message": "image-to-video mode requires exactly one starting image",
  "data": {
    "category": "invalid_request",
    "field": "image_start",
    "action": "select_single_starting_image",
    "expected_count": 1,
    "actual_count": 2,
    "retryable": false,
    "submission_state": "rejected",
    "charge_status": "not_charged"
  }
}