Skip to main content
默认错误响应使用 OpenAI 风格的 error 包装。 
{
  "error": {
    "message": "prompt 不能为空",
    "type": "invalid_request_error",
    "code": "invalid_request_error"
  }
}

​
常见错误

HTTPcode含义调用方建议
400invalid_request_error / invalid_reference_image参数错误、prompt 为空、参考图异常。提示用户修改参数。
401missing_api_key / invalid_api_keyAPI Key 缺失或错误。检查密钥配置。
402insufficient_balance余额不足。提示充值或联系管理员。
403model_not_allowedAPI Key 没有模型权限。检查模型白名单。
404not_found任务不存在或不属于当前用户。停止轮询。
429rate_limit_rpmRPM 限流。降低并发，稍后重试。
500internal_error / billing_error服务内部异常。记录日志并稍后重试。
502 / 503upstream_error / service_unavailable图片渠道暂时不可用。可重试或提示用户稍后再试。

​
处理建议

  • 对 400 展示明确的参数提示。
  • 对 401 和 403 提示检查密钥或权限。
  • 对 429 做退避重试，不要立即高频重试。
  • 对 502 和 503 可允许用户重试。
  • 对 404 任务查询停止轮询，避免浪费请求。