---
title: ジョブを一覧表示
description: ジョブを一覧表示。
canonical_url: https://orchestor.io/docs/creative/rest-api/endpoint-reference/creative-jobs/get-list-creative-jobs
markdown_url: https://orchestor.io/docs/creative/rest-api/endpoint-reference/creative-jobs/get-list-creative-jobs.md
---

# ジョブを一覧表示

ジョブを一覧表示。

```http
GET /v1/creative/jobs
```

Server: https://api.orchestor.io

Operation ID: `listCreativeJobs`

## 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": "limit",
    "in": "query",
    "required": false,
    "description": "1 ページで取得する件数。上限と既定値はスキーマを参照してください。",
    "schema": {
      "minimum": 1,
      "maximum": 100,
      "type": "integer"
    }
  },
  {
    "name": "type",
    "in": "query",
    "required": false,
    "description": "取得する生成ジョブの種類。省略するとすべての種類を取得します。",
    "schema": {
      "minLength": 1,
      "type": "string"
    }
  },
  {
    "name": "types",
    "in": "query",
    "required": false,
    "description": "複数の種類をまとめて取得する場合に、types=image-router&types=video-router のように繰り返して指定します。type と同時には指定できません。",
    "style": "form",
    "explode": true,
    "schema": {
      "minItems": 1,
      "type": "array",
      "items": {
        "minLength": 1,
        "type": "string"
      }
    }
  },
  {
    "name": "status",
    "in": "query",
    "required": false,
    "description": "取得するジョブの処理状態。",
    "schema": {
      "type": "string",
      "enumValues": [
        "queued",
        "processing",
        "completed",
        "failed",
        "canceled"
      ]
    }
  },
  {
    "name": "starting_after",
    "in": "query",
    "required": false,
    "description": "前のページの next_cursor。省略すると新しいジョブから取得します。",
    "schema": {
      "minLength": 1,
      "type": "string"
    }
  }
]
```

## Responses

### 200

```json
{
  "statusCode": "200",
  "description": "新しい順のジョブ一覧。next_cursor がある場合は starting_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": "JobsListResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "この操作が返す結果。形状は以下の子フィールドを参照してください。",
            "required": [
              "jobs"
            ],
            "properties": {
              "jobs": {
                "type": "array",
                "description": "条件に一致した生成ジョブの一覧。",
                "items": {
                  "name": "Job",
                  "type": "object",
                  "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
                      ]
                    }
                  }
                }
              },
              "next_cursor": {
                "type": "string",
                "description": "次のページを取得するためのカーソル。ジョブ一覧では starting_after に渡します。"
              }
            }
          }
        }
      },
      "example": {
        "data": {
          "jobs": [
            {
              "id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
              "type": "image_generation",
              "status": "queued",
              "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": null,
              "completed_at": null,
              "canceled_at": null,
              "result": null,
              "error": null,
              "usage_summary": null,
              "webhook_delivery": null,
              "input": {
                "model": "gpt-image-2",
                "prompt": "白い背景の上に置いた青い陶器の花瓶",
                "aspect_ratio": "1:1",
                "mode": "async"
              }
            }
          ]
        }
      }
    }
  ]
}
```

### 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?limit=20&status=completed' \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
```

```JavaScript
// Node.js 24 以上のサーバー側で実行します。
const response = await fetch("https://api.orchestor.io/v1/creative/jobs?limit=20&status=completed", {
  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?limit=20&status=completed',
    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)
