---
title: 動画モデルを一覧表示
description: 動画モデルを一覧表示。 レスポンス例の料金と利用量は形式を示すための値です。実際の値は取得したカタログを使用してください。
canonical_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-video-models
markdown_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-video-models.md
---

# 動画モデルを一覧表示

動画モデルを一覧表示。 レスポンス例の料金と利用量は形式を示すための値です。実際の値は取得したカタログを使用してください。

```http
GET /v1/creative/video-router/models
```

Server: https://api.orchestor.io

Operation ID: `listCreativeVideoModels`

## 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

No parameters.

## Responses

### 200

```json
{
  "statusCode": "200",
  "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": "VideoRouterModelsResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "この操作が返す結果。形状は以下の子フィールドを参照してください。",
            "required": [
              "models"
            ],
            "properties": {
              "models": {
                "type": "array",
                "description": "利用できるモデルと各モデルの対応入力・料金。",
                "items": {
                  "name": "VideoRouterCatalogItem",
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "modality",
                    "routing",
                    "capabilities",
                    "pricing",
                    "constraints"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "取得・更新時に指定する、このリソースの一意な識別子。",
                      "enumValues": [
                        "higgsfield-genjutsu",
                        "higgsfield-genjutsu-object-swap",
                        "higgsfield-genjutsu-light",
                        "higgsfield-genjutsu-light-object-swap",
                        "seedance-2.5",
                        "seedance-2-mini",
                        "seedance-2",
                        "seedance-2-fast",
                        "kling-3",
                        "wan-3.0",
                        "grok-imagine-video-1.5",
                        "minimax-h3",
                        "minimax-h3-max",
                        "minimax-h3-lite",
                        "minimax-h3-highspeed",
                        "wan-2.5-fast",
                        "gemini-omni-flash-1-2-extend",
                        "gemini-omni-flash-1.1",
                        "gemini-omni-flash-1.2",
                        "vidu-q4",
                        "vidu-q4-reference",
                        "veo-3.1",
                        "veo-3.1-fast",
                        "veo-3.1-lite",
                        "kling-4",
                        "kling-4-omni",
                        "kling-o1-video",
                        "flux-3-video-edit",
                        "minimax-02-fast",
                        "minimax-02",
                        "kling-3-omni-edit",
                        "kling-o1-video-edit",
                        "wan-2.2",
                        "wan-2.2-fast",
                        "grok-video-edit",
                        "kling-4-0-flash",
                        "flux-3-video",
                        "kling-2.5-turbo",
                        "wan-2.7",
                        "wan-2.6",
                        "wan-2.5",
                        "seedance-pro",
                        "seedance-pro-fast",
                        "grok-imagine-video",
                        "grok-imagine-video-1.5-lite",
                        "kling-motion-control",
                        "kling-3-motion-control",
                        "gemini-omni-flash-1-2-edit",
                        "seedance-2.5-edit",
                        "vidu-q3-pro",
                        "vidu-q3-turbo",
                        "vidu-q3",
                        "vidu-q3-mix",
                        "pixverse-c1",
                        "pixverse-v6",
                        "wand-vega-1.0-lite",
                        "wand-vega-1.0-pro",
                        "wand-vega-1.5-pro",
                        "mingmou-1",
                        "hailuo-h3-regen",
                        "heygen-video-1",
                        "kling-2.6",
                        "kling-3-turbo",
                        "kling-3-omni",
                        "hailuo-2.3",
                        "hailuo-2.3-fast",
                        "happy-horse-1.0",
                        "happy-horse-1.1",
                        "wan-3.0-prime",
                        "higgsfield-cinema-studio-4",
                        "veed-fabric-1.0",
                        "kling-avatar-2.0-pro",
                        "kling-avatar-2.0",
                        "omnihuman-1.5",
                        "omnihuman-2",
                        "wan-2.2-speech-to-video",
                        "sync-lipsync-3",
                        "sync-lipsync-2-pro",
                        "sync-lipsync-2",
                        "kling-lipsync",
                        "latentsync",
                        "veed-lipsync",
                        "pixverse-lipsync",
                        "veed-subtitles",
                        "veed-dubbing",
                        "topaz-video",
                        "sam-3.1-video",
                        "luma-ray-3.2-reframe",
                        "orchestor/depth-anything-video",
                        "orchestor/depth-anything-v3-video",
                        "orchestor/wand"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "description": "選択画面などに表示する名称。"
                    },
                    "modality": {
                      "type": "string",
                      "description": "モデルが生成するメディアの種類。",
                      "enumValues": [
                        "video"
                      ]
                    },
                    "routing": {
                      "type": "string",
                      "description": "モデルへの入力の渡し方と呼び出し経路の情報。",
                      "enumValues": [
                        "pass_through"
                      ]
                    },
                    "gated": {
                      "type": "boolean",
                      "description": "追加の利用条件を満たす必要があるかどうか。"
                    },
                    "capabilities": {
                      "type": "object",
                      "description": "テキスト生成・編集・参照入力など、このモデルが対応する機能。",
                      "required": [
                        "text_to_video",
                        "image_to_video",
                        "end_frame",
                        "reference_images",
                        "reference_videos",
                        "reference_audios",
                        "video_to_video",
                        "audio",
                        "resolutions",
                        "duration_seconds",
                        "aspect_ratios"
                      ],
                      "properties": {
                        "max_reference_images": {
                          "minimum": 1,
                          "type": "integer",
                          "description": "受け付ける参照入力の最大数。"
                        },
                        "max_reference_videos": {
                          "minimum": 1,
                          "type": "integer",
                          "description": "受け付ける参照入力の最大数。"
                        },
                        "max_reference_audios": {
                          "minimum": 1,
                          "type": "integer",
                          "description": "受け付ける参照入力の最大数。"
                        },
                        "max_reference_total": {
                          "minimum": 1,
                          "type": "integer",
                          "description": "参照入力の合計の最大数。"
                        },
                        "operation_settings": {
                          "type": "object",
                          "description": "Provider-documented settings for each supported generation operation.",
                          "additionalProperties": {
                            "type": "object",
                            "required": [
                              "resolutions",
                              "aspect_ratios",
                              "durations",
                              "audio"
                            ],
                            "properties": {
                              "resolutions": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "aspect_ratios": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "durations": {
                                "type": "array",
                                "items": {
                                  "type": "integer"
                                }
                              },
                              "audio": {
                                "type": "boolean"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "text_to_video": {
                          "type": "boolean",
                          "description": "文章から動画を生成できるかどうか。"
                        },
                        "image_to_video": {
                          "type": "boolean",
                          "description": "最初のフレームとなる画像から動画を生成できるかどうか。"
                        },
                        "end_frame": {
                          "type": "boolean",
                          "description": "最後のフレームを画像で指定できるかどうか。"
                        },
                        "reference_images": {
                          "type": "boolean",
                          "description": "参照画像入力への対応条件。"
                        },
                        "reference_videos": {
                          "type": "boolean",
                          "description": "参照動画入力への対応条件。"
                        },
                        "reference_audios": {
                          "type": "boolean",
                          "description": "参照音声入力への対応条件。"
                        },
                        "video_to_video": {
                          "type": "boolean",
                          "description": "入力動画を編集できるかどうか。"
                        },
                        "audio": {
                          "type": "boolean",
                          "description": "音声の生成または入力への対応条件。"
                        },
                        "resolutions": {
                          "type": "array",
                          "description": "このモデルで指定できる出力解像度の一覧。",
                          "items": {
                            "type": "string"
                          }
                        },
                        "duration_seconds": {
                          "type": "object",
                          "description": "指定可能な動画の秒数。モデルごとの範囲を確認してください。",
                          "required": [
                            "min",
                            "max"
                          ],
                          "properties": {
                            "min": {
                              "type": "integer",
                              "description": "許可される値の下限。"
                            },
                            "max": {
                              "type": "integer",
                              "description": "許可される値の上限。"
                            }
                          },
                          "additionalProperties": false
                        },
                        "aspect_ratios": {
                          "type": "array",
                          "description": "このモデルで指定できる縦横比の一覧。",
                          "items": {
                            "type": "string"
                          }
                        },
                        "duration_seconds_by_mode": {
                          "type": "object",
                          "description": "生成方式ごとの動画の長さの制約。",
                          "properties": {
                            "text_to_video": {
                              "type": "object",
                              "description": "文章から動画を生成できるかどうか。",
                              "required": [
                                "min",
                                "max"
                              ],
                              "properties": {
                                "min": {
                                  "type": "integer",
                                  "description": "許可される値の下限。"
                                },
                                "max": {
                                  "type": "integer",
                                  "description": "許可される値の上限。"
                                }
                              },
                              "additionalProperties": false
                            },
                            "image_to_video": {
                              "type": "object",
                              "description": "最初のフレームとなる画像から動画を生成できるかどうか。",
                              "required": [
                                "min",
                                "max"
                              ],
                              "properties": {
                                "min": {
                                  "type": "integer",
                                  "description": "許可される値の下限。"
                                },
                                "max": {
                                  "type": "integer",
                                  "description": "許可される値の上限。"
                                }
                              },
                              "additionalProperties": false
                            },
                            "reference_to_video": {
                              "type": "object",
                              "description": "参照メディアを使って動画を生成できるかどうか。",
                              "required": [
                                "min",
                                "max"
                              ],
                              "properties": {
                                "min": {
                                  "type": "integer",
                                  "description": "許可される値の下限。"
                                },
                                "max": {
                                  "type": "integer",
                                  "description": "許可される値の上限。"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "additionalProperties": false
                        },
                        "seed": {
                          "type": "boolean",
                          "description": "再現性の調整に使う乱数シード。0〜4,294,967,295。"
                        },
                        "motion_control": {
                          "type": "boolean",
                          "description": "動作参照動画のモーションをキャラクター画像に適用できるかを示します。"
                        },
                        "upscale": {
                          "type": "boolean",
                          "description": "元の動画の解像度やフレームレートを上げられるかを示します。"
                        },
                        "lipsync": {
                          "type": "boolean",
                          "description": "入力音声に合わせて映像内の口の動きを調整できるかを示します。"
                        },
                        "captions": {
                          "type": "boolean",
                          "description": "動画への字幕の追加に対応しているかを示します。"
                        }
                      },
                      "additionalProperties": false
                    },
                    "pricing": {
                      "type": "object",
                      "description": "課金単位とモデルの単価。生成前の見積もりに使用します。",
                      "required": [
                        "basis"
                      ],
                      "properties": {
                        "basis": {
                          "type": "string",
                          "description": "画像数、秒数、解像度など、単価を適用する基準。",
                          "enumValues": [
                            "per_1000_video_tokens",
                            "per_second",
                            "per_second_by_resolution"
                          ]
                        },
                        "credits_per_1000_video_tokens": {
                          "minimum": 0,
                          "type": "number",
                          "description": "動画トークン 1,000 個あたりの消費クレジット。"
                        },
                        "credits_per_second": {
                          "minimum": 0,
                          "type": "number",
                          "description": "動画 1 秒あたりの消費クレジット。"
                        },
                        "credits_per_second_audio_on": {
                          "minimum": 0,
                          "type": "number",
                          "description": "音声生成を有効にした場合の動画 1 秒あたりの消費クレジット。"
                        },
                        "credits_per_second_by_resolution": {
                          "type": "object",
                          "description": "解像度ごとの動画 1 秒あたりの消費クレジット。",
                          "additionalProperties": {
                            "minimum": 0,
                            "type": "number"
                          }
                        },
                        "usd_per_second": {
                          "pattern": "^\\d+\\.\\d{4,}$",
                          "type": "string",
                          "description": "動画 1 秒あたりの USD 単価。"
                        },
                        "usd_per_second_audio_on": {
                          "pattern": "^\\d+\\.\\d{4,}$",
                          "type": "string",
                          "description": "音声生成を有効にした場合の動画 1 秒あたりの USD 単価。"
                        },
                        "usd_per_second_by_resolution": {
                          "type": "object",
                          "description": "解像度ごとの動画 1 秒あたりの USD 単価。",
                          "additionalProperties": {
                            "pattern": "^\\d+\\.\\d{4,}$",
                            "type": "string"
                          }
                        },
                        "usd_options": {
                          "type": "array",
                          "description": "生成オプションによる USD 単価の差。",
                          "items": {
                            "type": "object",
                            "required": [
                              "label",
                              "usd"
                            ],
                            "properties": {
                              "label": {
                                "type": "string",
                                "description": "画面に表示する項目の名前。"
                              },
                              "resolution": {
                                "type": "string",
                                "description": "出力の解像度。モデルが対応する値をカタログで確認します。"
                              },
                              "audio": {
                                "type": "boolean",
                                "description": "音声の生成または入力への対応条件。"
                              },
                              "quality": {
                                "type": "string",
                                "description": "モデルが受け付ける生成品質。対応する値はカタログで確認します。"
                              },
                              "usd": {
                                "pattern": "^\\d+\\.\\d{4,}$",
                                "type": "string",
                                "description": "指定した処理の料金。単位は USD。"
                              }
                            },
                            "additionalProperties": false
                          }
                        }
                      },
                      "additionalProperties": false
                    },
                    "constraints": {
                      "type": "array",
                      "description": "モデルごとに受け付ける解像度、入力数、長さなどの制約。",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "example": {
        "data": {
          "models": [
            {
              "id": "seedance-2.5",
              "name": "Seedance 2.5",
              "modality": "video",
              "routing": "pass_through",
              "capabilities": {
                "text_to_video": true,
                "image_to_video": true,
                "end_frame": true,
                "reference_images": true,
                "reference_videos": true,
                "reference_audios": true,
                "video_to_video": true,
                "audio": true,
                "resolutions": [],
                "duration_seconds": {
                  "min": 0,
                  "max": 0
                },
                "aspect_ratios": []
              },
              "pricing": {
                "basis": "per_1000_video_tokens"
              },
              "constraints": []
            }
          ]
        }
      }
    }
  ]
}
```

### 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/video-router/models' \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
```

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