---
title: 音楽モデルを一覧表示
description: 入力画像や秒数指定への対応、料金と制約を比較して曲を生成するモデルを選びます。
  料金と利用量の例は形式を示す値です。実際の値は取得したカタログで確認してください。
canonical_url: https://orchestor.io/docs/creative/rest-api/endpoint-reference/creative-models/get-list-creative-music-models
markdown_url: https://orchestor.io/docs/creative/rest-api/endpoint-reference/creative-models/get-list-creative-music-models.md
---

# 音楽モデルを一覧表示

入力画像や秒数指定への対応、料金と制約を比較して曲を生成するモデルを選びます。 料金と利用量の例は形式を示す値です。実際の値は取得したカタログで確認してください。

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

Server: https://api.orchestor.io

Operation ID: `listCreativeMusicModels`

## 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": "指定した対象の取得結果。次の要求には返された ID と制約を使用します。",
  "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"
      }
    },
    {
      "name": "x-orchestor-poll-after",
      "in": "header",
      "required": false,
      "description": "次のジョブ状態取得までの待機秒数。",
      "schema": {
        "minimum": 0,
        "type": "integer"
      }
    }
  ],
  "content": [
    {
      "contentType": "application/json",
      "schema": {
        "name": "MusicRouterModelsResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "呼び出し結果を格納するオブジェクト。エラー時は error を確認してください。",
            "required": [
              "models"
            ],
            "properties": {
              "models": {
                "type": "array",
                "description": "このルーターで選択できるモデルと、それぞれの対応入力・料金・制約。",
                "items": {
                  "name": "MusicRouterCatalogItem",
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "modality",
                    "routing",
                    "capabilities",
                    "pricing",
                    "constraints"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "生成要求の model に渡すカタログ ID。別名ではなく、この値をそのまま指定します。",
                      "enumValues": [
                        "orchestor/music-auto",
                        "lyria-3-pro"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "description": "モデル選択画面に表示する名称。要求には名称ではなく id を指定します。"
                    },
                    "modality": {
                      "type": "string",
                      "description": "生成されるメディアの種類。音声・音楽モデルは audio を返します。",
                      "enumValues": [
                        "audio"
                      ]
                    },
                    "routing": {
                      "type": "string",
                      "description": "指定したモデルへ直接送るか、カタログの選択規則で別のモデルへ解決するかを示します。",
                      "enumValues": [
                        "auto",
                        "pass_through"
                      ]
                    },
                    "resolves_to": {
                      "type": "string",
                      "description": "自動選択の行が現在解決するモデル ID。実行前にカタログで確認します。",
                      "enumValues": [
                        "orchestor/music-auto",
                        "lyria-3-pro"
                      ]
                    },
                    "capabilities": {
                      "type": "object",
                      "description": "利用可能な入力や設定の範囲。記載のない設定を要求に追加しないでください。",
                      "required": [
                        "text_to_music",
                        "image_conditioning",
                        "lyrics",
                        "max_prompt_characters"
                      ],
                      "properties": {
                        "text_to_music": {
                          "type": "boolean",
                          "description": "文章の指示から楽曲を生成する入力に対応しているかを示します。"
                        },
                        "image_conditioning": {
                          "type": "boolean",
                          "description": "画像を楽曲生成の参照入力として使用できるかを示します。"
                        },
                        "lyrics": {
                          "type": "boolean",
                          "description": "歌詞を指定した生成に対応しているかを示します。"
                        },
                        "max_prompt_characters": {
                          "type": "integer",
                          "description": "楽曲の指示として送れる文章の文字数上限。"
                        },
                        "duration_seconds": {
                          "type": "object",
                          "description": "指定可能な音声の秒数。項目がない場合はモデルが長さを決めます。",
                          "required": [
                            "min",
                            "max",
                            "default"
                          ],
                          "properties": {
                            "min": {
                              "type": "integer",
                              "description": "指定できる長さの下限。単位は秒です。"
                            },
                            "max": {
                              "type": "integer",
                              "description": "指定できる長さの上限。単位は秒です。"
                            },
                            "default": {
                              "type": "integer",
                              "description": "長さを省略したときに適用する秒数。"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "pricing": {
                      "type": "object",
                      "description": "生成量に適用する課金単位と単価。要求全体の金額は入力の長さなどに応じて計算します。",
                      "required": [
                        "basis",
                        "credits_per_audio",
                        "usd_per_audio"
                      ],
                      "properties": {
                        "basis": {
                          "type": "string",
                          "description": "単価を適用する生成量の単位。文字数、音声一つ、秒数、分数を区別します。",
                          "enumValues": [
                            "per_audio",
                            "per_second",
                            "per_minute"
                          ]
                        },
                        "credits_per_audio": {
                          "minimum": 0,
                          "type": "integer",
                          "description": "一回の音声生成で消費するクレジット。長さによる課金では既定の長さに対する値。"
                        },
                        "usd_per_audio": {
                          "pattern": "^\\d+\\.\\d{4,}$",
                          "type": "string",
                          "description": "一回の音声生成の USD 金額。長さによる課金では既定の長さに対する値。"
                        },
                        "credits_per_minute": {
                          "minimum": 0,
                          "type": "integer",
                          "description": "生成音声 1 分あたりに消費するクレジット。"
                        },
                        "usd_per_minute": {
                          "pattern": "^\\d+\\.\\d{4,}$",
                          "type": "string",
                          "description": "生成音声 1 分あたりの USD 単価。"
                        }
                      },
                      "additionalProperties": false
                    },
                    "constraints": {
                      "type": "array",
                      "description": "文字数、長さ、入力の組み合わせなど、要求が満たす必要のある条件。",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "example": {
        "data": {
          "models": [
            {
              "id": "lyria-3-pro",
              "name": "lyria-3-pro",
              "modality": "audio",
              "routing": "pass_through",
              "constraints": [],
              "capabilities": {
                "text_to_music": true,
                "image_conditioning": true,
                "lyrics": false,
                "max_prompt_characters": 5000
              },
              "pricing": {
                "basis": "per_audio",
                "credits_per_audio": 0,
                "usd_per_audio": "0.0000"
              }
            }
          ]
        }
      }
    }
  ]
}
```

### 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",
                  "project_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"
        }
      }
    }
  ]
}
```

### 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",
                  "project_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"
        }
      }
    }
  ]
}
```

## Examples

```cURL
curl --request GET 'https://api.orchestor.io/v1/creative/music-router/models' \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
```

```JavaScript
const response = await fetch('https://api.orchestor.io/v1/creative/music-router/models', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.ORCHESTOR_API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
```

```Python
import os
import requests

response = requests.get(
    'https://api.orchestor.io/v1/creative/music-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)
