---
title: 声の候補を一覧表示
description: モデルの voice_family を family に指定し、返された声の id を生成要求の voice.id
  に使います。対応する声がない系列では空の一覧を返します。
canonical_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-tts-voices
markdown_url: https://orchestor.io/docs/en/creative/rest-api/endpoint-reference/creative-models/get-list-creative-tts-voices.md
---

# 声の候補を一覧表示

モデルの voice_family を family に指定し、返された声の id を生成要求の voice.id に使います。対応する声がない系列では空の一覧を返します。

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

Server: https://api.orchestor.io

Operation ID: `listCreativeTtsVoices`

## Authentication

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

## Parameters

```json
[
  {
    "name": "family",
    "in": "query",
    "required": true,
    "description": "モデルと声を組み合わせる系列。別系列の ID を混在させないでください。",
    "schema": {
      "type": "string",
      "enumValues": [
        "sonic",
        "eleven",
        "seed_audio",
        "qwen",
        "minimax",
        "seed_speech"
      ]
    }
  },
  {
    "name": "purpose",
    "in": "query",
    "required": false,
    "description": "voice_change と family=eleven を指定すると、アカウントで利用できる ElevenLabs の既定ボイスを返します。",
    "schema": {
      "type": "string",
      "enumValues": [
        "voice_change"
      ]
    }
  }
]
```

## 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": "TtsRouterVoicesResponse",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "description": "呼び出し結果を格納するオブジェクト。エラー時は error を確認してください。",
            "required": [
              "family",
              "source",
              "voices"
            ],
            "properties": {
              "family": {
                "type": "string",
                "description": "モデルと声を組み合わせる系列。別系列の ID を混在させないでください。",
                "enumValues": [
                  "sonic",
                  "eleven",
                  "seed_audio",
                  "qwen",
                  "minimax",
                  "seed_speech"
                ]
              },
              "source": {
                "type": "string",
                "description": "声一覧の取得元。live はライブラリ、premade は既定の声、preset は固定プリセットです。",
                "enumValues": [
                  "live",
                  "premade",
                  "preset"
                ]
              },
              "voices": {
                "type": "array",
                "description": "指定した family の声の候補。生成時にはこの中の id を使います。",
                "items": {
                  "name": "TtsRouterVoice",
                  "type": "object",
                  "required": [
                    "id",
                    "family",
                    "name",
                    "description",
                    "language",
                    "gender",
                    "accent",
                    "country",
                    "preview_url",
                    "tags",
                    "supported_models"
                  ],
                  "properties": {
                    "source": {
                      "type": "string",
                      "description": "custom は現在のワークスペースが作成したボイスです。省略時はプリセットです。",
                      "enumValues": [
                        "preset",
                        "custom"
                      ]
                    },
                    "id": {
                      "type": "string",
                      "description": "生成要求の voice.id に指定する声の ID。表示名ではなく一覧の値をそのまま使います。"
                    },
                    "family": {
                      "type": "string",
                      "description": "モデルと声を組み合わせる系列。別系列の ID を混在させないでください。",
                      "enumValues": [
                        "sonic",
                        "eleven",
                        "seed_audio",
                        "qwen",
                        "minimax",
                        "seed_speech"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "description": "声を選ぶときに表示する名前。要求には id を指定します。"
                    },
                    "description": {
                      "type": "string",
                      "nullable": true,
                      "description": "声の特徴を説明する文章。情報がない場合は null です。"
                    },
                    "language": {
                      "type": "string",
                      "nullable": true,
                      "description": "読み上げる言語の BCP-47 または ISO 639 コード。日本語なら ja を明示します。"
                    },
                    "gender": {
                      "type": "string",
                      "nullable": true,
                      "description": "声の性別表現。分類されていない場合は null です。",
                      "enumValues": [
                        "male",
                        "female",
                        "neutral",
                        null
                      ]
                    },
                    "accent": {
                      "type": "string",
                      "nullable": true,
                      "description": "声のアクセント。情報がない場合は null です。"
                    },
                    "country": {
                      "pattern": "^[A-Z]{2}$",
                      "type": "string",
                      "nullable": true,
                      "description": "声に関連付けられた国の2文字コード。情報がない場合は null です。"
                    },
                    "preview_url": {
                      "type": "string",
                      "nullable": true,
                      "description": "声を試聴する音声 URL。用意されていない場合は null です。"
                    },
                    "tags": {
                      "type": "array",
                      "description": "声の特徴で候補を絞るための分類。プリセットでは category、notice、studio_quality、user_count、language などを key:value 形式で返します。",
                      "items": {
                        "type": "string"
                      }
                    },
                    "supported_models": {
                      "type": "array",
                      "description": "この声を使える音声モデルの ID 一覧。",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "example": {
        "data": {
          "family": "sonic",
          "source": "preset",
          "voices": []
        }
      }
    }
  ]
}
```

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

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

### 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/tts-router/voices?family=eleven' \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
```

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