---
title: ジョブを取得
description: ジョブを取得。
canonical_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-jobs/get-get-creative-job
markdown_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-jobs/get-get-creative-job.md
---

# ジョブを取得

ジョブを取得。

```http
GET /v1/creative/jobs/{id}
```

Server: https://api.orchestor.io

Operation ID: `getCreativeJob`

## Authentication

```json
[
  [
    {
      "key": "bearerAuth",
      "type": "http",
      "description": "外部 API キー。session は受け付けません。apiKey と同時に送ると 401 です。",
      "scheme": "bearer",
      "scopes": []
    }
  ],
  [
    {
      "key": "apiKey",
      "type": "apiKey",
      "description": "外部 API キー。bearerAuth と同時に送ると 401 です。",
      "name": "x-api-key",
      "in": "header",
      "scopes": []
    }
  ]
]
```

## Parameters

```json
[
  {
    "name": "id",
    "in": "path",
    "required": true,
    "description": "操作対象のリソース ID。同じワークスペースに属するものを指定します。",
    "schema": {
      "type": "string"
    },
    "example": "job_7513b52d-3669-4ffe-b317-8b02000715eb"
  }
]
```

## Responses

### 200

```json
{
  "statusCode": "200",
  "description": "ジョブの入力、時刻、結果、エラー、料金精算、Webhook 配信の詳細。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "JobResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "この操作が返す結果。形状は以下の子フィールドを参照してください。",
            "required": [
              "job"
            ],
            "properties": {
              "job": {
                "name": "Job",
                "type": "object",
                "description": "生成ジョブの入力、状態、時刻、結果をまとめた情報。",
                "required": [
                  "id",
                  "type",
                  "status",
                  "model",
                  "idempotency_key",
                  "communication_mode",
                  "created_at",
                  "updated_at",
                  "started_at",
                  "completed_at",
                  "canceled_at",
                  "result",
                  "error",
                  "usage_summary",
                  "webhook_delivery"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "状態・結果・取消・通知の照合に使う生成ジョブ ID。"
                  },
                  "type": {
                    "type": "string",
                    "description": "対象の種類。ジョブでは生成種別、成果物ではメディア種別を示します。"
                  },
                  "status": {
                    "type": "string",
                    "description": "queued は待機中、processing は生成中。completed、failed、canceled で処理が終了します。",
                    "enumValues": [
                      "queued",
                      "processing",
                      "completed",
                      "failed",
                      "canceled"
                    ]
                  },
                  "model": {
                    "type": "string",
                    "nullable": true,
                    "description": "モデルカタログの ID。モデルが受け付ける入力と制約は対応するカタログ行で確認します。"
                  },
                  "idempotency_key": {
                    "type": "string",
                    "nullable": true,
                    "description": "生成の重複を防ぐため送信時に指定したキー。未指定なら null。"
                  },
                  "communication_mode": {
                    "type": "string",
                    "description": "生成送信時に選択した応答方式。",
                    "enumValues": [
                      "async",
                      "sync",
                      "subscribe",
                      "webhook"
                    ]
                  },
                  "created_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "このリソースを作成した日時。ISO 8601 形式。"
                  },
                  "updated_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "状態を最後に更新した日時。ISO 8601 形式。"
                  },
                  "started_at": {
                    "type": "string",
                    "nullable": true,
                    "format": "date-time",
                    "description": "生成を開始した日時。未開始なら null。"
                  },
                  "completed_at": {
                    "type": "string",
                    "nullable": true,
                    "format": "date-time",
                    "description": "生成が完了した日時。未完了なら null。"
                  },
                  "canceled_at": {
                    "type": "string",
                    "nullable": true,
                    "format": "date-time",
                    "description": "取消が完了した日時。取り消していなければ null。"
                  },
                  "result": {
                    "name": "JobResultPayload",
                    "type": "object",
                    "nullable": true,
                    "description": "生成された成果物。処理中や失敗時は null。",
                    "properties": {
                      "artifacts": {
                        "type": "array",
                        "description": "生成した画像・動画・音声の成果物。各 URL からファイルを取得できます。",
                        "items": {
                          "name": "Artifact",
                          "type": "object",
                          "required": [
                            "id",
                            "type",
                            "url",
                            "content_type"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "取得・更新時に指定する、このリソースの一意な識別子。"
                            },
                            "public_artifact_id": {
                              "type": "string",
                              "description": "生成メディアを外部で照合する不透明な ID。値から所有者や保存先を推測しないでください。"
                            },
                            "stage": {
                              "type": "string",
                              "description": "first_frame・pose_frame・scene_preview など、成果物が生成工程のどの段階で作られたかを示します。"
                            },
                            "type": {
                              "type": "string",
                              "description": "対象の種類。ジョブでは生成種別、成果物ではメディア種別を示します。",
                              "enumValues": [
                                "image",
                                "video",
                                "audio",
                                "model",
                                "file"
                              ]
                            },
                            "url": {
                              "type": "string",
                              "format": "uri",
                              "description": "対象ファイルまたは通知先の HTTPS URL。"
                            },
                            "content_type": {
                              "type": "string",
                              "nullable": true,
                              "description": "ファイルの MIME タイプ。例は image/png、video/mp4。"
                            },
                            "size_bytes": {
                              "type": "integer",
                              "nullable": true,
                              "description": "ファイルの正確なサイズ。単位はバイト。"
                            },
                            "width": {
                              "type": "integer",
                              "nullable": true,
                              "description": "画像またはフレームの幅。単位はピクセル。"
                            },
                            "height": {
                              "type": "integer",
                              "nullable": true,
                              "description": "画像またはフレームの高さ。単位はピクセル。"
                            },
                            "duration_ms": {
                              "type": "integer",
                              "nullable": true,
                              "description": "動画または音声の再生時間。単位はミリ秒。"
                            },
                            "checksum_sha256": {
                              "pattern": "^[a-f0-9]{64}$",
                              "type": "string",
                              "nullable": true,
                              "description": "ファイルの SHA-256。取得したバイト列の整合性確認に使用する 64 桁の小文字16進数。"
                            }
                          }
                        }
                      },
                      "transcript_receipt": {
                        "type": "object",
                        "description": "生成入力が受理済み原稿と一致したことを示す、サーバー発行の証明。",
                        "required": [
                          "job_id",
                          "script_revision_id",
                          "sentence_ids",
                          "canonicalization_version",
                          "submitted_transcript_sha256",
                          "input_integrity"
                        ],
                        "properties": {
                          "job_id": {
                            "type": "string",
                            "description": "検証または結果取得の対象となる生成ジョブの ID。"
                          },
                          "script_revision_id": {
                            "type": "string",
                            "description": "受理済み原稿の版を指定する ID。同じ認証文脈で取得した値を使います。"
                          },
                          "sentence_ids": {
                            "type": "array",
                            "description": "原稿内の文を示す ID の配列。生成入力では重複させず、連続した原稿順に指定します。",
                            "items": {
                              "type": "string"
                            }
                          },
                          "canonicalization_version": {
                            "type": "string",
                            "description": "原稿を NFC と LF に正規化して文へ分割する規則の版。",
                            "enumValues": [
                              "nfc-lf-sentence-v1"
                            ]
                          },
                          "submitted_transcript_sha256": {
                            "pattern": "^[a-f0-9]{64}$",
                            "type": "string",
                            "description": "実際に読み上げへ渡した文章の SHA-256。受理した原稿との一致確認に使います。"
                          },
                          "input_integrity": {
                            "type": "string",
                            "description": "受理済み原稿との結び付きをサーバーが検証した結果。利用者が自己申告する値ではありません。",
                            "enumValues": [
                              "source_bound"
                            ]
                          }
                        },
                        "additionalProperties": false
                      },
                      "generation_config": {
                        "type": "object",
                        "nullable": true,
                        "description": "モデルが capabilities.settings に公開している音量・速度・感情の設定だけを指定します。",
                        "properties": {
                          "volume": {
                            "type": "number",
                            "description": "音量の倍率。1が元の音量です。モデルごとの範囲内で指定します。"
                          },
                          "speed": {
                            "type": "number",
                            "description": "読み上げ速度。generation_config では数値倍率、直下では旧形式の slow・normal・fast です。"
                          },
                          "emotion": {
                            "type": "string",
                            "description": "読み上げの感情。モデルの対応一覧にある値を指定します。"
                          }
                        },
                        "additionalProperties": true
                      },
                      "speed": {
                        "type": "string",
                        "nullable": true,
                        "description": "読み上げ速度。generation_config では数値倍率、直下では旧形式の slow・normal・fast です。"
                      },
                      "text": {
                        "type": "string",
                        "description": "文字起こしの文章。文区間ではその区間の文章を返します。"
                      },
                      "language_code": {
                        "type": "string",
                        "nullable": true,
                        "description": "文字起こしの言語ヒント。省略時は自動判定し、結果では検出した言語を返します。"
                      },
                      "language_probability": {
                        "type": "number",
                        "nullable": true,
                        "description": "検出した言語の確信度。取得できない場合は null です。"
                      },
                      "words": {
                        "type": "array",
                        "description": "開始時刻順の単語と秒単位の時刻。TTS の入力では true でこれらの出力を要求します。",
                        "items": {
                          "type": "object",
                          "properties": {
                            "word": {
                              "type": "string",
                              "description": "文字起こしされた単語またはトークン。"
                            },
                            "start": {
                              "type": "number",
                              "description": "音声の先頭から区間開始までの秒数。"
                            },
                            "end": {
                              "type": "number",
                              "description": "音声の先頭から区間終了までの秒数。"
                            },
                            "type": {
                              "type": "string",
                              "description": "単語や空白など、返されたトークンの分類。"
                            }
                          },
                          "additionalProperties": true
                        }
                      },
                      "words_truncated": {
                        "type": "boolean",
                        "description": "単語配列が20,000件の上限で切り詰められた場合だけ true を返します。"
                      },
                      "words_total": {
                        "type": "integer",
                        "description": "切り詰める前の単語件数。words_truncated と併せて返します。"
                      },
                      "segments": {
                        "type": "array",
                        "description": "順番に並ぶ文区間。隣接する区間の境界を共有し、時刻から必要な範囲を切り出せます。",
                        "items": {
                          "type": "object",
                          "properties": {
                            "index": {
                              "type": "integer",
                              "description": "文区間の順番。0から数えます。"
                            },
                            "text": {
                              "type": "string",
                              "description": "文字起こしの文章。文区間ではその区間の文章を返します。"
                            },
                            "start": {
                              "type": "number",
                              "description": "音声の先頭から区間開始までの秒数。"
                            },
                            "end": {
                              "type": "number",
                              "description": "音声の先頭から区間終了までの秒数。"
                            },
                            "duration_seconds": {
                              "type": "number",
                              "description": "処理対象または生成する音声の秒数。STT の申告値は料金を決めず、音楽では対応モデルだけが受け付けます。"
                            }
                          },
                          "additionalProperties": true
                        }
                      },
                      "audio_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "生成音声の取得先 URL。TTS、音楽、声の変換で返します。"
                      },
                      "video_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "声の変換や吹替後の動画の取得先 URL。"
                      },
                      "model_id": {
                        "type": "string",
                        "description": "実際に音声を生成したエンジンの ID。ジョブの model と区別します。"
                      },
                      "voice": {
                        "type": "object",
                        "description": "使用する声の指定。モデルの voice_family に一致する一覧から ID を選びます。",
                        "properties": {
                          "mode": {
                            "type": "string",
                            "description": "声の ID を指定する方式。現在は id のみを受け付けます。",
                            "default": "id",
                            "enumValues": [
                              "id"
                            ]
                          },
                          "id": {
                            "minLength": 1,
                            "maxLength": 128,
                            "type": "string",
                            "description": "生成要求の voice.id に指定する声の ID。表示名ではなく一覧の値をそのまま使います。"
                          }
                        },
                        "additionalProperties": false
                      },
                      "language": {
                        "type": "string",
                        "description": "読み上げる言語の BCP-47 または ISO 639 コード。日本語なら ja を明示します。"
                      },
                      "output_format": {
                        "type": "object",
                        "description": "出力音声の形式。モデルの capabilities.output_formats にある組み合わせを指定します。",
                        "properties": {
                          "container": {
                            "type": "string",
                            "description": "音声ファイルのコンテナ。文ごとの音声切り出しには wav または raw を使います。",
                            "enumValues": [
                              "mp3",
                              "wav",
                              "raw"
                            ]
                          },
                          "sample_rate": {
                            "type": "integer",
                            "description": "音声のサンプルレート。単位は Hz。モデルが対応する値を選びます。",
                            "enumValues": [
                              8000,
                              16000,
                              22050,
                              24000,
                              32000,
                              44100,
                              48000
                            ]
                          },
                          "bit_rate": {
                            "type": "integer",
                            "description": "MP3 の毎秒ビット数。MP3 の既定形式を変更するときに指定します。",
                            "enumValues": [
                              32000,
                              64000,
                              96000,
                              128000,
                              192000
                            ]
                          },
                          "encoding": {
                            "type": "string",
                            "description": "wav または raw で使用する PCM の符号化形式。",
                            "enumValues": [
                              "pcm_f32le",
                              "pcm_s16le",
                              "pcm_mulaw",
                              "pcm_alaw"
                            ]
                          }
                        },
                        "additionalProperties": false
                      },
                      "preview_image_url": {
                        "type": "string",
                        "nullable": true,
                        "format": "uri",
                        "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                      },
                      "scene": {
                        "type": "object",
                        "nullable": true,
                        "description": "背景を文章または写真で指定します。",
                        "required": [
                          "type",
                          "status",
                          "preview_image_url"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "この要素の形式を選ぶ識別子。選んだ形式の必須フィールドを併せて指定します。",
                            "enumValues": [
                              "prompt",
                              "photo",
                              "none"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "description": "現在の準備・処理状態。利用する前に ready または completed になったことを確認します。",
                            "enumValues": [
                              "queued",
                              "processing",
                              "ready",
                              "failed",
                              "canceled"
                            ]
                          },
                          "preview_image_url": {
                            "type": "string",
                            "nullable": true,
                            "format": "uri",
                            "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                          },
                          "image_url": {
                            "type": "string",
                            "format": "uri",
                            "description": "参照する静止画の取得可能な公開 HTTPS URL。人物 ID・ハンドルとの併用はできません。"
                          }
                        },
                        "additionalProperties": false
                      },
                      "scene_previews": {
                        "type": "array",
                        "description": "各シーンの構図を確認する静止画一覧です。",
                        "items": {
                          "name": "AvatarVideoScenePreview",
                          "type": "object",
                          "required": [
                            "index",
                            "status",
                            "preview_image_url",
                            "scene"
                          ],
                          "properties": {
                            "index": {
                              "minimum": 0,
                              "type": "integer",
                              "description": "順序付きシーンの中でこの要素が占める位置です。"
                            },
                            "id": {
                              "type": "string",
                              "description": "この要素を後で参照・取得するときに使う識別子です。"
                            },
                            "status": {
                              "type": "string",
                              "description": "現在の準備・処理状態。利用する前に ready または completed になったことを確認します。",
                              "enumValues": [
                                "queued",
                                "processing",
                                "ready",
                                "failed",
                                "canceled"
                              ]
                            },
                            "preview_image_url": {
                              "type": "string",
                              "nullable": true,
                              "format": "uri",
                              "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                            },
                            "scene": {
                              "name": "AvatarVideoScenePreviewReference",
                              "type": "object",
                              "description": "背景を文章または写真で指定します。",
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "description": "prompt は文章、photo は写真、props は人物属性を使う入力形式。none は背景指定がない結果を表します。列挙値の範囲で選びます。",
                                  "enumValues": [
                                    "prompt",
                                    "photo",
                                    "none"
                                  ]
                                },
                                "image_url": {
                                  "type": "string",
                                  "format": "uri",
                                  "description": "参照する静止画の取得可能な公開 HTTPS URL。人物 ID・ハンドルとの併用はできません。"
                                }
                              },
                              "additionalProperties": false
                            },
                            "avatar_handle": {
                              "type": "string",
                              "description": "再利用する人物のハンドル。先頭の @ を除き小文字で保存します。英数字・ピリオド・アンダースコアを使い、区切り記号の先頭・末尾・連続使用は避けます。"
                            },
                            "start_time_seconds": {
                              "minimum": 0,
                              "type": "number",
                              "description": "このシーンの開始時刻を秒で示します。"
                            },
                            "end_time_seconds": {
                              "minimum": 0,
                              "type": "number",
                              "description": "このシーンの終了時刻を秒で示します。"
                            },
                            "duration_seconds": {
                              "minimum": 0,
                              "type": "number",
                              "description": "出力や料金予約の基準になる長さを秒で指定します。各操作の上限以内の値を使います。"
                            }
                          },
                          "additionalProperties": false
                        }
                      }
                    },
                    "additionalProperties": true
                  },
                  "error": {
                    "name": "JobError",
                    "type": "object",
                    "nullable": true,
                    "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
                    "required": [
                      "category",
                      "stage",
                      "retryable",
                      "retry_after_seconds",
                      "public_reason",
                      "next_action"
                    ],
                    "properties": {
                      "code": {
                        "name": "CreativeErrorCode",
                        "type": "string",
                        "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                        "enumValues": [
                          "bad_request",
                          "invalid_request",
                          "unknown_parameter",
                          "unauthorized",
                          "session_not_accepted",
                          "insufficient_funds",
                          "not_enough_credits",
                          "api_key_spend_limit_exceeded",
                          "insufficient_scope",
                          "open_key_route_not_allowed",
                          "open_key_required",
                          "not_found",
                          "idempotency_conflict",
                          "draft_expired",
                          "job_not_completed",
                          "job_failed",
                          "job_canceled",
                          "job_generation_already_started",
                          "job_not_cancelable",
                          "webhook_not_configured",
                          "job_not_terminal",
                          "asset_upload_incomplete",
                          "top_up_in_dashboard",
                          "payload_too_large",
                          "asset_too_large",
                          "unsupported_media_type",
                          "queue_full",
                          "rate_limited",
                          "provider_rate_limited",
                          "internal_error",
                          "billing_in_dashboard",
                          "provider_submission_failed",
                          "provider_capacity_exceeded",
                          "provider_not_configured",
                          "database_busy",
                          "deploy_draining",
                          "overloaded",
                          "replica_not_ready",
                          "api_key_auth_unavailable",
                          "asset_storage_unavailable"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "description": "利用者に表示できる処理結果または失敗理由の説明。"
                      },
                      "category": {
                        "type": "string",
                        "description": "入力、認証、課金、生成など、失敗原因の分類。",
                        "enumValues": [
                          "validation",
                          "auth",
                          "quota",
                          "queue",
                          "generation_unavailable",
                          "generation_rejected",
                          "generation_timeout",
                          "runtime_unavailable",
                          "worker_timeout",
                          "internal"
                        ]
                      },
                      "stage": {
                        "type": "string",
                        "description": "入力検証、受付、生成、決済など、失敗が発生した段階。",
                        "enumValues": [
                          "validation",
                          "queue",
                          "usage_reservation",
                          "generation_submit",
                          "generation_processing",
                          "usage_settlement",
                          "webhook_delivery",
                          "cancellation",
                          "internal"
                        ]
                      },
                      "retryable": {
                        "type": "boolean",
                        "description": "入力を変えずに後から再試行できるかどうか。"
                      },
                      "retry_after_seconds": {
                        "type": "integer",
                        "nullable": true,
                        "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
                      },
                      "public_reason": {
                        "type": "string",
                        "description": "利用者に公開できる失敗理由の識別子。"
                      },
                      "next_action": {
                        "type": "string",
                        "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                        "enumValues": [
                          "fix_input",
                          "authenticate",
                          "add_funds",
                          "retry_later",
                          "poll_status",
                          "inspect_events",
                          "contact_support"
                        ]
                      },
                      "details": {
                        "type": "object",
                        "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。",
                        "properties": {
                          "alignment_reason": {
                            "type": "string",
                            "description": "音声と文章の時刻合わせに失敗した理由。",
                            "enumValues": [
                              "invalid_alignment_payload",
                              "empty_aligned_words",
                              "invalid_stt_span",
                              "overlapping_stt_spans",
                              "non_monotonic_timings",
                              "script_coverage_mismatch"
                            ]
                          },
                          "script_word_count": {
                            "minimum": 0,
                            "type": "integer",
                            "description": "時刻合わせ対象の原稿に含まれる単語数。"
                          },
                          "stt_word_count": {
                            "minimum": 0,
                            "type": "integer",
                            "description": "音声認識で得られた単語数。"
                          },
                          "ffmpeg_error": {
                            "type": "string",
                            "description": "メディア処理中のエラーの説明。機密情報を除いた内容です。"
                          },
                          "provider_error_type": {
                            "type": "string",
                            "description": "モデル提供元のエラー分類。"
                          },
                          "provider_error_message": {
                            "type": "string",
                            "description": "モデル提供元のエラーから公開可能な範囲を取り出した説明。"
                          },
                          "input_field": {
                            "type": "string",
                            "description": "問題のある入力フィールドのパス。"
                          },
                          "segment_index": {
                            "minimum": 0,
                            "type": "integer",
                            "description": "問題が起きた区間の 0 始まりの位置。"
                          },
                          "source_slot": {
                            "type": "string",
                            "description": "問題がある入力メディアのスロット名。"
                          },
                          "source_status": {
                            "type": "integer",
                            "description": "入力ファイルの取得先が返した HTTP ステータス。"
                          },
                          "source_host": {
                            "type": "string",
                            "description": "入力ファイルの取得先ホスト名。認証情報を含めません。"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "usage_summary": {
                    "name": "JobUsageSummary",
                    "type": "object",
                    "nullable": true,
                    "description": "ジョブの予約、確定、返金、解放した利用量。",
                    "required": [
                      "status",
                      "reserved_credits",
                      "captured_credits",
                      "refunded_credits",
                      "released_credits",
                      "final",
                      "updated_at"
                    ],
                    "properties": {
                      "status": {
                        "type": "string",
                        "description": "料金の精算状態。reserved は予約中、captured は確定、refunded は返金済み。",
                        "enumValues": [
                          "reserved",
                          "captured",
                          "refunded"
                        ]
                      },
                      "reserved_credits": {
                        "minimum": 0,
                        "type": "number",
                        "description": "受付時に予約したクレジット。"
                      },
                      "captured_credits": {
                        "minimum": 0,
                        "type": "number",
                        "description": "完了により消費が確定したクレジット。"
                      },
                      "refunded_credits": {
                        "minimum": 0,
                        "type": "number",
                        "description": "失敗や取消により返したクレジット。"
                      },
                      "released_credits": {
                        "minimum": 0,
                        "type": "number",
                        "description": "未使用の予約を解放したクレジット。"
                      },
                      "reserved_usd_cents": {
                        "minimum": 0,
                        "type": "integer",
                        "description": "予約した料金。単位は USD セント。"
                      },
                      "captured_usd_cents": {
                        "minimum": 0,
                        "type": "integer",
                        "description": "消費が確定した料金。単位は USD セント。"
                      },
                      "refunded_usd_cents": {
                        "minimum": 0,
                        "type": "integer",
                        "description": "返金した料金。単位は USD セント。"
                      },
                      "released_usd_cents": {
                        "minimum": 0,
                        "type": "integer",
                        "description": "未使用の予約から解放した料金。単位は USD セント。"
                      },
                      "final": {
                        "type": "boolean",
                        "description": "料金の精算が確定し、今後変更しないかどうか。"
                      },
                      "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "状態を最後に更新した日時。ISO 8601 形式。"
                      }
                    }
                  },
                  "webhook_delivery": {
                    "name": "WebhookDelivery",
                    "type": "object",
                    "nullable": true,
                    "description": "終端イベントの配信先、試行回数、直近の応答。",
                    "required": [
                      "url",
                      "event_type",
                      "status",
                      "attempts",
                      "max_attempts",
                      "next_attempt_at",
                      "last_attempt_at",
                      "delivered_at",
                      "last_status_code",
                      "last_error",
                      "signature_version",
                      "signing_secret_fingerprint"
                    ],
                    "properties": {
                      "url": {
                        "type": "string",
                        "nullable": true,
                        "format": "uri",
                        "description": "対象ファイルまたは通知先の HTTPS URL。"
                      },
                      "event_type": {
                        "type": "string",
                        "nullable": true,
                        "description": "配信した通知の種類。",
                        "enumValues": [
                          "job.completed",
                          "job.failed",
                          "job.canceled",
                          null
                        ]
                      },
                      "status": {
                        "type": "string",
                        "description": "通知の配信状況。exhausted は試行回数の上限に達した状態で、ジョブ自体の成否とは別です。",
                        "enumValues": [
                          "pending",
                          "delivering",
                          "delivered",
                          "retrying",
                          "failed",
                          "exhausted"
                        ]
                      },
                      "attempts": {
                        "type": "integer",
                        "description": "これまでに行った配信の試行回数。"
                      },
                      "max_attempts": {
                        "type": "integer",
                        "description": "配信を試みる回数の上限。終端通知は最大 8 回です。"
                      },
                      "next_attempt_at": {
                        "type": "string",
                        "nullable": true,
                        "format": "date-time",
                        "description": "再配信を予定している日時。予定がなければ null。"
                      },
                      "last_attempt_at": {
                        "type": "string",
                        "nullable": true,
                        "format": "date-time",
                        "description": "最後に配信を試みた日時。未試行なら null。"
                      },
                      "delivered_at": {
                        "type": "string",
                        "nullable": true,
                        "format": "date-time",
                        "description": "受信先が 2xx で受領した日時。未配信なら null。"
                      },
                      "last_status_code": {
                        "type": "integer",
                        "nullable": true,
                        "description": "直近の配信先の HTTP ステータス。応答がなければ null。"
                      },
                      "last_error": {
                        "type": "string",
                        "nullable": true,
                        "description": "直近の配信で発生したエラー。問題がなければ null。"
                      },
                      "signature_version": {
                        "type": "string",
                        "description": "通知署名の形式。v1 は Standard Webhooks の webhook-signature（<webhook-id>.<webhook-timestamp>.<body> の HMAC-SHA256 を Base64 で表した値）です。同じ通知に orchestor-v1 の署名も付けます。"
                      },
                      "signing_secret_fingerprint": {
                        "type": "string",
                        "nullable": true,
                        "description": "使用した署名シークレットを区別する指紋。シークレット自体ではありません。"
                      },
                      "manual_redeliveries": {
                        "minimum": 0,
                        "type": "integer",
                        "description": "利用者が手動で再配信を依頼した回数。"
                      }
                    }
                  },
                  "input": {
                    "type": "object",
                    "description": "生成に使用した入力。ジョブの再現や送信内容の確認に使います。",
                    "additionalProperties": true
                  },
                  "preview_image_url": {
                    "type": "string",
                    "nullable": true,
                    "format": "uri",
                    "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                  },
                  "scene": {
                    "type": "object",
                    "nullable": true,
                    "description": "背景を文章または写真で指定します。",
                    "required": [
                      "type",
                      "status",
                      "preview_image_url"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "この要素の形式を選ぶ識別子。選んだ形式の必須フィールドを併せて指定します。",
                        "enumValues": [
                          "prompt",
                          "photo",
                          "none"
                        ]
                      },
                      "status": {
                        "type": "string",
                        "description": "現在の準備・処理状態。利用する前に ready または completed になったことを確認します。",
                        "enumValues": [
                          "queued",
                          "processing",
                          "ready",
                          "failed",
                          "canceled"
                        ]
                      },
                      "preview_image_url": {
                        "type": "string",
                        "nullable": true,
                        "format": "uri",
                        "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                      },
                      "image_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "参照する静止画の取得可能な公開 HTTPS URL。人物 ID・ハンドルとの併用はできません。"
                      }
                    },
                    "additionalProperties": false
                  },
                  "scene_previews": {
                    "type": "array",
                    "nullable": true,
                    "description": "各シーンの構図を確認する静止画一覧です。",
                    "items": {
                      "name": "AvatarVideoScenePreview",
                      "type": "object",
                      "required": [
                        "index",
                        "status",
                        "preview_image_url",
                        "scene"
                      ],
                      "properties": {
                        "index": {
                          "minimum": 0,
                          "type": "integer",
                          "description": "順序付きシーンの中でこの要素が占める位置です。"
                        },
                        "id": {
                          "type": "string",
                          "description": "この要素を後で参照・取得するときに使う識別子です。"
                        },
                        "status": {
                          "type": "string",
                          "description": "現在の準備・処理状態。利用する前に ready または completed になったことを確認します。",
                          "enumValues": [
                            "queued",
                            "processing",
                            "ready",
                            "failed",
                            "canceled"
                          ]
                        },
                        "preview_image_url": {
                          "type": "string",
                          "nullable": true,
                          "format": "uri",
                          "description": "準備済みの代表静止画 URL。まだ使える画像がない場合は null です。"
                        },
                        "scene": {
                          "name": "AvatarVideoScenePreviewReference",
                          "type": "object",
                          "description": "背景を文章または写真で指定します。",
                          "required": [
                            "type"
                          ],
                          "properties": {
                            "type": {
                              "type": "string",
                              "description": "prompt は文章、photo は写真、props は人物属性を使う入力形式。none は背景指定がない結果を表します。列挙値の範囲で選びます。",
                              "enumValues": [
                                "prompt",
                                "photo",
                                "none"
                              ]
                            },
                            "image_url": {
                              "type": "string",
                              "format": "uri",
                              "description": "参照する静止画の取得可能な公開 HTTPS URL。人物 ID・ハンドルとの併用はできません。"
                            }
                          },
                          "additionalProperties": false
                        },
                        "avatar_handle": {
                          "type": "string",
                          "description": "再利用する人物のハンドル。先頭の @ を除き小文字で保存します。英数字・ピリオド・アンダースコアを使い、区切り記号の先頭・末尾・連続使用は避けます。"
                        },
                        "start_time_seconds": {
                          "minimum": 0,
                          "type": "number",
                          "description": "このシーンの開始時刻を秒で示します。"
                        },
                        "end_time_seconds": {
                          "minimum": 0,
                          "type": "number",
                          "description": "このシーンの終了時刻を秒で示します。"
                        },
                        "duration_seconds": {
                          "minimum": 0,
                          "type": "number",
                          "description": "出力や料金予約の基準になる長さを秒で指定します。各操作の上限以内の値を使います。"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "transcript_receipt": {
                    "type": "object",
                    "description": "原稿と音声の対応関係を確認するための検証結果です。",
                    "required": [
                      "job_id",
                      "script_revision_id",
                      "sentence_ids",
                      "canonicalization_version",
                      "submitted_transcript_sha256",
                      "input_integrity"
                    ],
                    "properties": {
                      "job_id": {
                        "type": "string",
                        "description": "進行状況の照会に使う関連ジョブの ID です。"
                      },
                      "script_revision_id": {
                        "type": "string",
                        "description": "音声に使った受理済み原稿の版を特定します。"
                      },
                      "sentence_ids": {
                        "type": "array",
                        "description": "その音声に含まれる原稿中の文を順番に特定します。",
                        "items": {
                          "type": "string"
                        }
                      },
                      "canonicalization_version": {
                        "type": "string",
                        "description": "原稿の比較前に適用した正規化方式の版です。",
                        "enumValues": [
                          "nfc-lf-sentence-v1"
                        ]
                      },
                      "submitted_transcript_sha256": {
                        "pattern": "^[a-f0-9]{64}$",
                        "type": "string",
                        "description": "送信原稿を比較するための SHA256 値です。"
                      },
                      "input_integrity": {
                        "type": "string",
                        "description": "送信した原稿の一致を確認するための検証情報です。",
                        "enumValues": [
                          "source_bound"
                        ]
                      }
                    },
                    "additionalProperties": false
                  },
                  "auth_source": {
                    "type": "string",
                    "nullable": true,
                    "description": "ジョブの認証経路を表す分類。資格情報の値は含みません。",
                    "enumValues": [
                      "api_key",
                      null
                    ]
                  }
                }
              },
              "linked_resource": {
                "type": "null",
                "description": "このジョブに紐づく別リソース。画像・動画の共通ジョブでは null。"
              }
            }
          }
        }
      },
      "example": {
        "data": {
          "job": {
            "id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
            "type": "image_generation",
            "status": "completed",
            "model": "gpt-image-2",
            "idempotency_key": "9816bc88-9791-43a1-86c2-876dc7c544e8",
            "communication_mode": "async",
            "created_at": "2026-11-06T00:00:00Z",
            "updated_at": "2026-11-06T00:00:00Z",
            "started_at": "2026-11-06T00:00:00Z",
            "completed_at": "2026-11-06T00:00:00Z",
            "canceled_at": null,
            "result": {
              "artifacts": [
                {
                  "id": "artf_6f1d0c2b9a8e4f7d",
                  "type": "image",
                  "url": "https://media.orchestor.io/artifacts/artf_6f1d0c2b9a8e4f7d/image.png",
                  "content_type": "image/png",
                  "size_bytes": 482113,
                  "width": 1024,
                  "height": 1024,
                  "duration_ms": null
                }
              ]
            },
            "error": null,
            "usage_summary": null,
            "webhook_delivery": null,
            "input": {
              "model": "gpt-image-2",
              "prompt": "白い背景の上に置いた青い陶器の花瓶",
              "aspect_ratio": "1:1",
              "mode": "async"
            }
          },
          "linked_resource": null
        }
      }
    }
  ]
}
```

### 400

```json
{
  "statusCode": "400",
  "description": "入力が不正です。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "invalid_request",
          "message": "入力が不正です。必須項目、型、範囲を確認して修正してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "validation",
          "stage": "validation",
          "retryable": false,
          "retry_after_seconds": null,
          "public_reason": "invalid_request",
          "next_action": "fix_input"
        }
      }
    }
  ]
}
```

### 401

```json
{
  "statusCode": "401",
  "description": "認証が必要です。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "unauthorized",
          "message": "認証が必要です。有効な API キーと認証ヘッダーを確認してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "authentication",
          "stage": "authentication",
          "retryable": false,
          "retry_after_seconds": null,
          "public_reason": "unauthorized",
          "next_action": "authenticate"
        }
      }
    }
  ]
}
```

### 403

```json
{
  "statusCode": "403",
  "description": "API キーの権限または利用上限により要求が拒否されました。従量課金の USD 残高が生成料金に足りない場合は not_enough_credits を返し、ジョブと予約を作りません。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "insufficient_scope",
          "message": "API キーの権限が不足しています。必要な権限を持つ API キーを指定してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "authorization",
          "stage": "authorization",
          "retryable": false,
          "retry_after_seconds": null,
          "public_reason": "insufficient_scope",
          "next_action": "authenticate"
        }
      }
    }
  ]
}
```

### 404

```json
{
  "statusCode": "404",
  "description": "対象が見つかりません。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "not_found",
          "message": "対象が見つかりません。ルート、モデル、ジョブとワークスペースの所属を確認してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "validation",
          "stage": "validation",
          "retryable": false,
          "retry_after_seconds": null,
          "public_reason": "not_found",
          "next_action": "fix_input"
        }
      }
    }
  ]
}
```

### 429

```json
{
  "statusCode": "429",
  "description": "リクエスト数または生成キューの上限を超えました。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "queue_full",
          "message": "受付枠が埋まっています。retry-after 後に同じ入力と冪等性キーで再試行してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "capacity",
          "stage": "admission",
          "retryable": true,
          "retry_after_seconds": 30,
          "public_reason": "queue_full",
          "next_action": "retry_later"
        }
      }
    }
  ]
}
```

### 500

```json
{
  "statusCode": "500",
  "description": "処理中に内部エラーが発生しました。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "internal_error",
          "message": "処理中に内部エラーが発生しました。待機後にバックオフして再試行してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "internal",
          "stage": "processing",
          "retryable": true,
          "retry_after_seconds": 30,
          "public_reason": "internal_error",
          "next_action": "retry_later"
        }
      }
    }
  ]
}
```

### 502

```json
{
  "statusCode": "502",
  "description": "モデル提供元への送信に失敗しました。retryable を確認してください。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "provider_submission_failed",
          "message": "モデル提供元への送信に失敗しました。retry-after 後に同じ入力と冪等性キーで再試行してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "provider",
          "stage": "submission",
          "retryable": true,
          "retry_after_seconds": 30,
          "public_reason": "provider_submission_failed",
          "next_action": "retry_later"
        }
      }
    }
  ]
}
```

### 503

```json
{
  "statusCode": "503",
  "description": "サービスまたはモデルが一時的に利用できません。retry-after を確認してください。",
  "headers": [
    {
      "name": "x-orchestor-request-id",
      "in": "header",
      "required": false,
      "description": "HTTP リクエストの相関 ID。ジョブの request_id とは別の値。",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ratelimit-limit",
      "in": "header",
      "required": false,
      "description": "現在の期間で許可されるリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-remaining",
      "in": "header",
      "required": false,
      "description": "現在の期間で残っているリクエスト数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "ratelimit-reset",
      "in": "header",
      "required": false,
      "description": "制限がリセットされるまでの秒数。",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "retry-after",
      "in": "header",
      "required": false,
      "description": "再試行までの待機秒数。",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "ErrorEnvelope",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "description": "失敗理由と再試行に必要な情報。失敗していなければ null。",
            "required": [
              "code",
              "message",
              "request_id",
              "category",
              "stage",
              "retryable",
              "retry_after_seconds",
              "public_reason",
              "next_action"
            ],
            "properties": {
              "code": {
                "name": "CreativeErrorCode",
                "type": "string",
                "description": "失敗原因を識別する機械処理向けコード。message の文字列で分岐しないでください。",
                "enumValues": [
                  "bad_request",
                  "invalid_request",
                  "unknown_parameter",
                  "unauthorized",
                  "session_not_accepted",
                  "insufficient_funds",
                  "not_enough_credits",
                  "api_key_spend_limit_exceeded",
                  "insufficient_scope",
                  "open_key_route_not_allowed",
                  "open_key_required",
                  "not_found",
                  "idempotency_conflict",
                  "draft_expired",
                  "job_not_completed",
                  "job_failed",
                  "job_canceled",
                  "job_generation_already_started",
                  "job_not_cancelable",
                  "webhook_not_configured",
                  "job_not_terminal",
                  "asset_upload_incomplete",
                  "top_up_in_dashboard",
                  "payload_too_large",
                  "asset_too_large",
                  "unsupported_media_type",
                  "queue_full",
                  "rate_limited",
                  "provider_rate_limited",
                  "internal_error",
                  "billing_in_dashboard",
                  "provider_submission_failed",
                  "provider_capacity_exceeded",
                  "provider_not_configured",
                  "database_busy",
                  "deploy_draining",
                  "overloaded",
                  "replica_not_ready",
                  "api_key_auth_unavailable",
                  "asset_storage_unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "利用者に表示できる処理結果または失敗理由の説明。"
              },
              "request_id": {
                "pattern": "^req_[a-f0-9]{32}$",
                "type": "string",
                "description": "この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。"
              },
              "category": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力、認証、課金、生成など、失敗原因の分類。"
              },
              "stage": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "入力検証、受付、生成、決済など、失敗が発生した段階。"
              },
              "retryable": {
                "type": "boolean",
                "description": "入力を変えずに後から再試行できるかどうか。"
              },
              "retry_after_seconds": {
                "type": "integer",
                "nullable": true,
                "description": "同じ要求を再試行するまで待つ秒数。再試行不要なら null。"
              },
              "public_reason": {
                "pattern": "^[a-z0-9_]+$",
                "type": "string",
                "description": "利用者に公開できる失敗理由の識別子。"
              },
              "next_action": {
                "type": "string",
                "description": "次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。",
                "enumValues": [
                  "fix_input",
                  "authenticate",
                  "add_funds",
                  "retry_later",
                  "poll_status",
                  "inspect_events",
                  "contact_support"
                ]
              },
              "details": {
                "description": "失敗原因を調べるための補足情報。内容はエラーコードごとに異なります。"
              }
            }
          }
        }
      },
      "example": {
        "error": {
          "code": "provider_capacity_exceeded",
          "message": "モデルの処理枠が埋まっています。retry-after 後に同じ入力と冪等性キーで再試行してください。",
          "request_id": "req_00000000000000000000000000000000",
          "category": "capacity",
          "stage": "submission",
          "retryable": true,
          "retry_after_seconds": 30,
          "public_reason": "provider_capacity_exceeded",
          "next_action": "retry_later"
        }
      }
    }
  ]
}
```

## Examples

```cURL
curl --request GET 'https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb' \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
```

```JavaScript
// Node.js 24 以上のサーバー側で実行します。
const response = await fetch("https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb", {
  method: "GET",
  headers: {"Authorization": `Bearer ${process.env.ORCHESTOR_API_KEY}`},
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();
console.log(result);
```

```Python
import os
import requests

response = requests.request(
    'GET',
    'https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb',
    headers={'Authorization': f"Bearer {os.environ['ORCHESTOR_API_KEY']}"},
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

---

[Documentation index](https://orchestor.io/docs/llms.txt)
