错误码 - VidoCraft API 文档

错误使用标准 HTTP 状态码，响应体为稳定的机器可读格式：

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 10,
    "available": 2
  }
}

`code`	HTTP	含义	是否重试
`invalid_request`	400	参数缺失或无效（例如文件数超过模型上限，`param` 会指出字段），或输入被模型拒绝。message 会说明原因。	否，修复请求。
`moderation_blocked`	400	提示词、上传或引用的文件被内容审核拒绝，或引用的视频无法完成审核。	否，修改提示词或文件。
`media_not_uploaded`	400	某个素材输入不是本服务上的文件（也不在服务方批准的域名下）。请先用 `POST /api/v1/uploads` 上传（或使用之前任务的结果链接）。	否，先上传。
`media_unreadable`	400	读不出素材的尺寸或时长，无法计价，本次未扣积分。	可重试一次；仍失败请重新编码后上传。
`invalid_api_key`	401	密钥缺失、格式错误、已撤销或已过期。	否，使用有效密钥。
`insufficient_credits`	402	积分不足；响应体包含 `required` 和 `available`。	充值后重试。
`forbidden`	403	当前账户暂时无法使用 API，或该模型、所传的某个选项/参数需要订阅而当前账户没有（`param` 指明是哪个选项/参数）。message 会说明是哪种情况。	否。
`storage_quota_exceeded`	403	上传后会超出账户的存储配额。	清理空间或升级后重试。
`upload_suspended`	403	多个文件未通过内容审核，上传（以及引用批准域名素材）已被暂停。已在本服务上的文件仍可作为输入。	是，等 `Retry-After` 之后。
`not_found`	404	任务不存在或属于其他账户。	否。
`payload_too_large`	413	上传的文件超过大小上限。	否，换更小的文件。
`rate_limited`	429	请求过于频繁或进行中任务过多。	是，遵循 `Retry-After`。
`internal_error`	500	服务端错误。	是，退避后重试。