错误码

MoonApiX API 错误响应会返回统一的错误对象，方便你定位问题并进行重试或修正。

响应格式

json

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

HTTP 状态码	`type`	`code`	说明
`400`	`invalid_request_error`	`invalid_request`	请求体格式错误、缺少必填字段或字段类型不正确。
`400`	`invalid_request_error`	`invalid_parameter`	参数值不在模型支持范围内，例如尺寸、时长、比例或数量不合法。
`401`	`authentication_error`	`missing_api_key`	请求缺少 `Authorization` header。
`401`	`authentication_error`	`invalid_api_key`	API Key 不存在、已失效或格式错误。
`403`	`permission_error`	`model_not_enabled`	当前账号未开通所请求的模型或能力。
`404`	`not_found_error`	`task_not_found`	任务不存在，或不属于当前账号。
`409`	`task_error`	`task_canceled`	任务已取消，不能继续查询结果或重试当前任务。
`422`	`content_policy_error`	`asset_rejected`	上传素材或生成内容不符合平台安全规则。
`429`	`rate_limit_error`	`rate_limit_exceeded`	请求频率超过账号或模型限制。
`402`	`billing_error`	`insufficient_balance`	账号余额或额度不足。
`500`	`server_error`	`service_error`	MoonApiX 服务异常，请稍后重试。
`502`	`service_error`	`model_service_unavailable`	模型服务暂不可用，请稍后重试。
`504`	`timeout_error`	`request_timeout`	请求或任务等待超时。