错误码

接口概述

调用出错时：文本、图像、向量、重排类接口返回 {"detail": "说明文字"}；如果错误来自模型，则返回 502 并保留其原始错误正文，便于定位原因。视频接口与素材接口是方舟形状错误体（见下方两节）。

状态码

视频接口错误体

视频接口（/v1/videos/* 与 /api/v3/contents/generations/tasks*）的错误统一为：

{
  "error": {
    "code": "ResourceNotFound",
    "message": "The specified resource `cgt-xxx` is not found. Request id: 1f0c…",
    "param": "",
    "type": "NotFound"
  }
}

常用 code：MissingParameter（缺必填，如 model）、AuthenticationError（密钥无效）、Insufficient.Balance（余额不足，HTTP 403）、InvalidEndpointOrModel.NotFound（模型未上架）、ResourceNotFound（任务不存在或不属于当前密钥，HTTP 404）、RateLimitExceeded（限流）、InternalError（内部错误）。响应头带 x-request-id。

任务列表与取消/删除接口不提供（调用返回 404 ResourceNotFound）。

素材接口错误体

素材接口（/ 或 /v1/api/asset）的错误放在 ResponseMetadata.Error（Code / Message）：InvalidParameter、NotFound、InvalidApiKey、InsufficientBalance、QuotaExceeded、UnsupportedAction。详见视频生成-Seedance的「素材管理」章节。

示例

未认证（文本/图像类接口）：

{ "detail": "API Key 无效或已禁用" }

余额不足（文本/图像类接口）：

{ "detail": "余额不足，请联系管理员授信" }

余额不足（视频接口，方舟口径 403）：

{
  "error": {
    "code": "Insufficient.Balance",
    "message": "余额不足，请联系管理员授信",
    "param": "",
    "type": "Forbidden"
  }
}

模型报参数错误（502，保留原始正文）：

{
  "detail": "模型服务返回错误 400：{\"error\":{\"message\":\"Field required: input.query\"}}"
}

视频任务查不到（404，方舟形状）：

{
  "error": {
    "code": "ResourceNotFound",
    "message": "The specified resource `cgt-20260826160420-Tcwwi` is not found. Request id: 1f0c5b8e9a2d4c6f8b0e1a3d5c7f9b2e",
    "param": "",
    "type": "NotFound"
  }
}

常见报错速查