---
title: 音声モデルを一覧表示
description: モデルごとの声の系列、文字数上限、出力形式と料金を確認してから生成します。 料金と利用量の例は形式を示す値です。実際の値は取得したカタログで確認してください。
canonical_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-tts-models
markdown_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-tts-models.md
---

# 音声モデルを一覧表示

モデルごとの声の系列、文字数上限、出力形式と料金を確認してから生成します。 料金と利用量の例は形式を示す値です。実際の値は取得したカタログで確認してください。

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

Server: https://api.orchestor.io

Operation ID: `listCreativeTtsModels`

## 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": "TtsRouterModelsResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "呼び出し結果を格納するオブジェクト。エラー時は error を確認してください。",
            "required": [
              "models"
            ],
            "properties": {
              "models": {
                "type": "array",
                "description": "このルーターで選択できるモデルと、それぞれの対応入力・料金・制約。",
                "items": {
                  "name": "TtsRouterCatalogItem",
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "modality",
                    "routing",
                    "capabilities",
                    "pricing",
                    "constraints"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "生成要求の model に渡すカタログ ID。別名ではなく、この値をそのまま指定します。",
                      "enumValues": [
                        "sonic-3.6",
                        "sonic-3.5",
                        "sonic-3",
                        "sonic-latest",
                        "sonic-preview",
                        "sonic-2",
                        "sonic-turbo",
                        "eleven-v4",
                        "eleven-v4-turbo",
                        "eleven-v3",
                        "eleven-multilingual-v2",
                        "eleven-turbo-v2.5",
                        "seed-audio-1.0",
                        "qwen-audio-3.0-tts",
                        "minimax-speech-2.8-hd",
                        "seed-speech"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "description": "モデル選択画面に表示する名称。要求には名称ではなく id を指定します。"
                    },
                    "voice_family": {
                      "type": "string",
                      "description": "このモデルと組み合わせる声の一覧を選ぶ family の値。別の系列の声は使用できません。",
                      "enumValues": [
                        "sonic",
                        "eleven",
                        "seed_audio",
                        "qwen",
                        "minimax",
                        "seed_speech"
                      ]
                    },
                    "modality": {
                      "type": "string",
                      "description": "生成されるメディアの種類。音声・音楽モデルは audio を返します。",
                      "enumValues": [
                        "audio"
                      ]
                    },
                    "routing": {
                      "type": "string",
                      "description": "指定したモデルへ直接送るか、カタログの選択規則で別のモデルへ解決するかを示します。",
                      "enumValues": [
                        "pass_through"
                      ]
                    },
                    "capabilities": {
                      "type": "object",
                      "description": "利用可能な入力や設定の範囲。記載のない設定を要求に追加しないでください。",
                      "required": [
                        "text_to_speech",
                        "max_characters"
                      ],
                      "properties": {
                        "text_to_speech": {
                          "type": "boolean",
                          "description": "文章を音声に変換する入力に対応しているかを示します。"
                        },
                        "max_characters": {
                          "type": "integer",
                          "description": "一度の音声生成で入力できる文章の文字数上限。"
                        },
                        "languages": {
                          "type": "array",
                          "description": "音声生成で受け付ける言語の ISO 639-1 コード。",
                          "items": {
                            "type": "string"
                          }
                        },
                        "output_formats": {
                          "type": "array",
                          "description": "音声のコンテナ、サンプルレート、ビットレートを組み合わせた出力形式。",
                          "items": {
                            "type": "string"
                          }
                        },
                        "settings": {
                          "type": "object",
                          "description": "指定可能な声の設定ごとの min、max、step、default。項目がなければ指定できません。",
                          "additionalProperties": true
                        }
                      },
                      "additionalProperties": false
                    },
                    "pricing": {
                      "type": "object",
                      "description": "生成量に適用する課金単位と単価。要求全体の金額は入力の長さなどに応じて計算します。",
                      "required": [
                        "basis",
                        "credits_per_1000_characters"
                      ],
                      "properties": {
                        "basis": {
                          "type": "string",
                          "description": "単価を適用する生成量の単位。文字数、音声一つ、秒数、分数を区別します。",
                          "enumValues": [
                            "per_character"
                          ]
                        },
                        "credits_per_1000_characters": {
                          "minimum": 0,
                          "type": "number",
                          "nullable": true,
                          "description": "入力文章 1,000 文字あたりに消費するクレジット。換算価格が未設定の場合は null。"
                        }
                      },
                      "additionalProperties": false
                    },
                    "constraints": {
                      "type": "array",
                      "description": "文字数、長さ、入力の組み合わせなど、要求が満たす必要のある条件。",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "example": {
        "data": {
          "models": [
            {
              "id": "sonic-3.6",
              "name": "sonic-3.6",
              "modality": "audio",
              "routing": "pass_through",
              "constraints": [],
              "voice_family": "sonic",
              "capabilities": {
                "text_to_speech": true,
                "max_characters": 20000
              },
              "pricing": {
                "basis": "per_character",
                "credits_per_1000_characters": 0
              }
            }
          ]
        }
      }
    }
  ]
}
```

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

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

## Examples

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

```JavaScript
const response = await fetch('https://api.orchestor.io/v1/creative/tts-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/tts-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)
