文档中心

Appearance

费用中心控制台

图片和视频生成 API 错误码 ​

本页适用于 GenStudio 图片生成、视频生成、批量任务和相关文件上传接口。错误响应格式取决于所调用的端点。

多数平台接口返回包含 code、msg 和 data 的 JSON 响应体。HTTP 状态码可能为 200，但响应体 code 非 0 时仍表示失败：

language-json
{
  "code": 10024,
  "msg": "当前账号消费已超过预算金额上限",
  "data": null
}

部分 OpenAI 兼容图片接口返回嵌套的 error 对象：

language-json
{
  "error": {
    "code": 130001,
    "message": "JSON body missing required field: model"
  }
}

排查错误时，先根据实际响应确定字段格式：

  • 平台数字错误对象：code 为 0 通常表示成功；非 0 表示业务失败或系统失败。msg 是错误信息，data 在失败时可能为空。
  • OpenAI 图片错误对象：检查嵌套的 error.code 和 error.message。
  • 部分错误只返回 error 字段，不一定包含数字错误码；请同时检查 HTTP 状态码和完整响应体。
  • 本文档中用 {...} 表示运行时详情；实际响应会替换为具体字段、模型、限制值或失败原因。

标记为“已弃用”的错误码不应作为新集成的处理依据；现有集成如仍需兼容历史响应，可保留相应处理。请以各条目中的替代说明和接口实际响应为准。

10009 ​

  • HTTP 状态码：API Key 鉴权失败时为 401。
  • 错误信息："请使用正确的api key进行请求"
  • 适用场景：图片、视频和通用 API 鉴权。
  • 可能原因：API Key 无效、过期或请求头格式错误。
  • 处理建议：使用有效 API Key，并确认鉴权请求头格式正确。
  • 是否建议重试：否。

10017 ​

  • HTTP 状态码：因余额不足返回错误时为 200。
  • 错误信息："CashAccount: not enough balance"
  • 适用场景：需要计费的图片、视频或批量任务。
  • 可能原因：账户余额不足。
  • 处理建议：补足账户余额后重试。
  • 是否建议重试：否。

10024 ​

  • HTTP 状态码：因超过预算上限返回错误时为 200。
  • 错误信息："当前账号消费已超过预算金额上限"
  • 适用场景：需要计费的图片、视频或批量任务。
  • 可能原因：账号消费达到预算上限。
  • 处理建议：调整预算上限，或联系管理员处理预算限制。
  • 是否建议重试：否。

10025 ​

  • HTTP 状态码：200。
  • 错误信息：以实际响应为准，常见返回为 功能暂不可用。
  • 适用场景：接口返回功能暂不可用，且请求尚未开始处理。
  • 可能原因：当前账号暂时无法使用该 API。
  • 处理建议：确认服务开通状态和账号权限；如需继续使用，请联系管理员或技术支持。
  • 是否建议重试：否。

60000 ​

  • HTTP 状态码：Bearer Token 鉴权失败时为 401。
  • 错误信息："Wrong Bearer Token or Token is nil"
  • 适用场景：接口鉴权。
  • 可能原因：Bearer Token 缺失或错误。
  • 处理建议：检查 Authorization 请求头。
  • 是否建议重试：否。

60002 ​

  • 错误信息格式：Upload Image fail {reason}
  • 适用场景：图片上传或图片生成请求。
  • 可能原因：上传图片失败。
  • 处理建议：检查图片格式、大小和网络连接后重试。
  • 是否建议重试：是。

60003 ​

  • 错误信息格式：Can not use uploaded images to gen {task_type}
  • 适用场景：图生图或使用已上传图片生成。
  • 可能原因：当前上传图片不能用于指定生成任务。
  • 处理建议：更换图片，或确认模型和任务类型是否支持该输入。
  • 是否建议重试：否。

60004 ​

  • 错误信息："There are no eligible missions in sdTask"
  • 适用场景：图片生成任务。
  • 可能原因：没有可执行的图片生成任务。
  • 处理建议：检查任务状态、模型可用性和调用参数。
  • 是否建议重试：是。

60009 ​

  • 错误信息格式：get best sampling params fail [{reason}]
  • 适用场景：提交图片生成参数。
  • 可能原因：提交的生成参数暂时无法处理。
  • 处理建议：调整生成参数后重试；如持续出现，请联系技术支持。
  • 是否建议重试：是。

60012（已弃用） ​

  • 状态：已弃用。
  • 替代处理：不再使用单一错误码概括上传失败。批量文件上传可能根据具体情况返回 90001、90003、90005 或其他实际错误信息；其他上传接口请以实际响应为准。
  • 错误信息："Upload Image fail"
  • 适用场景：图片或文件上传。
  • 可能原因：上传文件失败。
  • 处理建议：检查文件、网络和重试策略。
  • 是否建议重试：是。

60013（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息："余额不足，请充值后重试"
  • 适用场景：图片、视频或其他计费任务。
  • 可能原因：余额不足。
  • 处理建议：充值后重试。
  • 是否建议重试：否。

60104（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息："There are no eligible missions in cogTask"
  • 适用场景：视频生成任务。
  • 可能原因：没有可执行的视频生成任务。
  • 处理建议：检查任务状态、模型可用性和调用参数。
  • 是否建议重试：是。

60200（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息："Enter hit AliCloud audit"
  • 适用场景：输入安全审核。
  • 可能原因：输入内容命中安全审核。
  • 处理建议：修改输入内容，避免提交违规内容。
  • 是否建议重试：否。

60300（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息格式：Has no permission to use this model，err[{reason}]
  • 适用场景：图片或视频模型调用。
  • 可能原因：当前租户没有使用该模型的权限。
  • 处理建议：确认模型是否已开通；如需使用该模型，请申请模型访问权限。
  • 是否建议重试：否。

61000 ​

  • HTTP 状态码：429。
  • 错误信息格式：{reason}
  • 适用场景：图片生成限制。
  • 可能原因：触发图片生成相关限制，具体原因以返回信息为准。
  • 处理建议：根据 msg 调整请求；如为频率或配额限制，请等待窗口释放。
  • 是否建议重试：视情况。

90001 ​

  • 错误信息格式：Single file size exceeds the maximum allowed limit: {limit}
  • 适用场景：批量任务文件上传。
  • 可能原因：单个上传文件超过大小限制。
  • 处理建议：减小文件大小或拆分文件。
  • 是否建议重试：否。

90002（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息格式：Total uploaded file size exceeds the tenant's allowed limit: {limit}
  • 适用场景：批量任务文件上传。
  • 可能原因：总上传文件大小超过租户限制。
  • 处理建议：减少文件数量或总大小。
  • 是否建议重试：否。

90003 ​

  • 错误信息格式：the input file has failed the validation process: {reason}
  • 适用场景：批量任务文件校验。
  • 可能原因：输入文件未通过校验。
  • 处理建议：按错误信息修正文件格式、字段或内容。
  • 是否建议重试：否。

90004（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息格式：the batch was not able to be completed within the specified time window: {reason}
  • 适用场景：批量任务执行。
  • 可能原因：批量任务无法在指定时间窗口内完成。
  • 处理建议：缩小任务规模，或调整任务提交时间。
  • 是否建议重试：是。

90005 ​

  • 错误信息格式：input batch file validate failed: {reason}
  • 适用场景：批量任务文件校验。
  • 可能原因：批量输入文件校验失败。
  • 处理建议：按错误信息修正文件后重新上传。
  • 是否建议重试：否。

90006（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息格式：current usage of this feature is restricted: {reason}
  • 适用场景：批量任务或受限功能。
  • 可能原因：当前功能被限制使用。
  • 处理建议：确认功能是否已开通，或联系技术支持。
  • 是否建议重试：否。

OpenAI 兼容图片接口错误 ​

以下错误适用于 OpenAI 兼容的图片生成和图片编辑接口。此类错误使用嵌套的 error 对象，并通过 HTTP 200 返回。

130001 ​

  • 错误信息：invalid multipart form、multipart form missing required field: model 或 JSON body missing required field: model。
  • 可能原因：Multipart 请求格式无效，或请求中缺少必填的 model 字段。
  • 处理建议：检查 Content-Type、Multipart 表单结构和 model 字段。
  • 是否建议重试：否。修正请求后再重新提交。

130002 ​

  • 错误信息格式：product image model not found, model:{model} 或 product image model is unavailable。
  • 可能原因：指定的图片模型不存在或当前不可用。
  • 处理建议：确认模型 ID 正确，并检查该模型当前是否可用。
  • 是否建议重试：视情况。模型 ID 错误时先修正请求；模型暂不可用时等待恢复后再重新提交。

130004 ​

  • 错误信息格式：failed to query product image model 或 multiple product image models matched, model:{model}。
  • 可能原因：模型信息暂时不可用，或模型信息存在冲突。
  • 处理建议：确认模型 ID 后稍后重试；如持续出现，请记录请求信息并联系技术支持。
  • 是否建议重试：视情况。模型信息暂时不可用时可稍后重试；信息冲突需要技术支持处理。