エラーとデバッグ

if (job.status === "failed") {
  switch (job.error?.code ?? "internal") {
    case "content_policy":
    case "model_unavailable":
      // 同じリクエストをリトライしても、再び失敗する可能性が高い。入力またはモデルを変更する。
      break;
    case "insufficient_balance":
      // API 残高をチャージしてから、再度送信する。
      break;
    default:
      // timeout、auto_cancelled、provider_error、internal、node_app_node_failed、
      // または不明なコード:バックオフを用いて再度送信する。
  }
}

{
  "error": "Validation failed",
  "details": [
    {
      "field": "width",
      "message": "Too small: expected number to be >0",
      "code": "too_small"
    },
    {
      "field": "",
      "message": "Unrecognized key: \"foo\"",
      "code": "unrecognized_keys"
    },
    {
      "field": "prompt",
      "message": "Enter a prompt.",
      "code": "custom"
    }
  ]
}

{
  "error": "invalid_request",
  "reason": "removed_field",
  "field": "batchSize",
  "message": "Generation batch size is no longer supported. Submit one request per output.",
  "value": 2
}

{
  "error": "model_unavailable",
  "reason": "deprecated",
  "message": "The model '<path>' was deprecated on <sunsetDate>. <reason> Use '<replacement>' instead.",
  "sunset_date": "YYYY-MM-DD",
  "replacement": "<optional>",
  "migration_url": "<optional>"
}

{
  "error": "Invalid JSON: Expected property name or '}' in JSON at position 1 (line 1 column 2)"
}

{ "message": "Unauthorized" }

{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}

{ "error": "Zero data retention is not enabled for this workspace." }

{ "message": "Job not found or unauthorized" }

{ "message": "Payload Too Large" }

{ "message": "Input file rejected: fetching <url> returned HTTP 404" }

{
  "message": "CONCURRENCY_LIMIT_REACHED",
  "limit": 4,
  "jobType": "k2"
}

{
  "status": "failed",
  "error": {
    "code": "content_policy",
    "message": "An external provider's moderation systems rejected the generation."
  }
}