Gemini Voices API

省略可。作成された音声が Google によって保存および管理されるかどうか。* `true` の場合、Google は音声を保存し、`Voice.id`（`voice_abc123def456` など）を返します。これは、`GetVoice`、`ListVoices`、`DeleteVoice` で管理でき、合成リクエストで ID を参照できます。保存された音声は、1 年間使用されないと期限切れになります。音声合成で保存された音声を使用するか、`CreateVoice` で `base_voice` として使用すると、`expire_time` が延長されます。プロジェクトには、アクティブな保存済み音声の最大割り当てが適用されます。割り当てを超えると、`RESOURCE_EXHAUSTED` が返されます。* `false`（デフォルト）の場合、音声は Google によって保存されず、クライアントサイドの保存と合成のために `Voice.key`（`voicekey_...` など）が返されます。`voice` のオプションの検出メタデータ フィールドは、`store` が `false` の場合、永続化されず、返されません。 * `voice.type` が `"prompted"` の場合、`true` である必要があります（そうでない場合、`INVALID_ARGUMENT` で失敗します）。

必須。作成する音声。`voice.model` は省略可能です。省略すると、サービスはデフォルトの音声作成モデルを選択します。`Voice` の出力専用フィールド（`id`、`key`、`expire_time`、`usage`）は、設定されている場合でも無視されます。

省略可。地域アクセント記述子（「アメリカ英語」、「イギリス英語」など）。

省略可。最適な使用コンテキストまたはドメイン（「会話」、「オーディオブック」、「ニュース」など）。

省略可。声の音色、個性、トーンに関する説明的な概要。

省略可。保存された音声のユーザー指定の表示名（`store = true`）、または事前構築済み音声のカタログ名。

出力専用。カスタム保存音声（`store = true`）または複製された音声キー（`store = false`）の有効期限が切れるタイムスタンプ。カスタム保存済み音声（`store = true`）の場合、この有効期限は、音声が音声合成に使用されるか、`CreateVoice` の `base_voice` として使用されると延長されます。有効期限のない事前構築済みカタログ音声（`"prebuilt"`）の場合は設定されません。

省略可。認識された音声の性別（「女性」、「男性」、「中性」など）。

出力専用。音声の固有識別子。* Google マネージド カスタム音声（`store = true`）の場合、これは接頭辞 `voice_` を含む生成された ID です（例: `voice_abc123def456`）。`GetVoice` と `DeleteVoice` の `name` として `voices/{id}` を渡し、音声合成時に `SpeechConfig.voice_config.voice`（または `SpeechConfig.voice`）に `{id}` を直接渡します。* プリビルド カタログ音声（`ListVoices` によって返される `"prebuilt"`）の場合、これはスピーカー名（`Puck` や `Charon` など）です。 * `store = false` で `CreateVoice` が呼び出された場合は設定されません。

出力専用。クライアント管理の音声レプリケーション キー（接頭辞 `voicekey_` を含む）。`type` が `"replicated"` で `store` が `false` の場合に `CreateVoice` によってのみ返されます。音声合成時にこのキーを `SpeechConfig.voice_config.voice`（または `SpeechConfig.voice`）に渡します。

省略可。プライマリ BCP-47 言語タグ（例: 「en-US」、「fr-FR」）。

省略可。音声の設計または複製に使用されたモデル。`CreateVoice` で省略すると、デフォルトでサポートされている最新の音声設計モデルが使用されます。カスタム音声（`"prompted"` と `"replicated"`）の `CreateVoice`、`GetVoice`、`ListVoices` レスポンスで返されます。`"prebuilt"` 音声の場合は設定されません。作成した音声は、サポートされている任意の TTS 合成モデルで合成できます。

省略可。想定されるペルソナまたはキャラクターのアーキタイプ（「温かくフレンドリー」、「ナレーター」など）。

省略可。ISO 3166-1 alpha-2 または UN M.49 の地理的地域コード（例: 「US」、「GB」、「001」）。

省略可。アクセントの説明（「アメリカ英語」、「イギリス英語」など）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合、指定されたアクセントのいずれかに一致する音声が検出されます（OR）。

省略可。意図するコンテキストまたはドメイン（「ニュース、商業」など）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合、指定されたコンテキストのいずれかに一致する音声が一致します（OR）。

省略可。性別表現（「女性」、「男性」、「中性」など）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合は、指定された性別のいずれかの音声と一致します（OR）。

省略可。BCP-47 言語コード（例: 「en-US」）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合は、指定された言語コードのいずれかに一致する音声が返されます（OR）。

省略可。ページごとに返す音声の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合、最大で 50 個の音声が返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

省略可。前回の `ListVoices` 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。ページネーションを行う場合、すべてのフィルタ クエリ パラメータ（`language_code`、`region_code`、`accent`、`persona`、`context`、`gender`、`pitch`、`type`、`search`）は、このトークンを返した呼び出しと一致する必要があります。一致しない場合、リクエストは `INVALID_ARGUMENT` で失敗します。`page_size` はページ間で変更できます。

省略可。音声のペルソナ（「温かい、フレンドリー」など）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合、指定されたペルソナのいずれかに一致する音声（OR）が返されます。

省略可。声のピッチでフィルタします。`"low"`、`"medium"`、`"high"`（大文字と小文字を区別しない）を受け入れます。複数の値が指定されている場合、指定されたピッチのいずれか（OR）と一致する音声が返されます。

省略可。ISO 3166-1 alpha-2 または UN M.49 地域コード（「US」、「001」など）でフィルタします。大文字と小文字を区別しない完全一致。複数の値が指定されている場合は、指定されたリージョン コードのいずれかに一致する音声が照合されます（OR）。

省略可。自由形式のテキストのサブ文字列検索クエリは、`display_name` と `description` の両方に対して大文字と小文字を区別せずに照合されます。最大 2,048 バイト。

省略可。声の種類でフィルタします。`"prebuilt"`、`"replicated"`、`"prompted"`（大文字と小文字を区別しない）を受け入れます。複数の値が指定されている場合は、指定されたタイプのいずれかの音声と一致します（OR）。

次のページを取得するために `page_token` として送信できるトークン。空の場合、後続のページはありません。

指定されたコレクションの音声。

必須。取得するカスタム保存済み音声のリソース名（例: `voices/voice_abc123def456`）。

省略可。地域アクセント記述子（「アメリカ英語」、「イギリス英語」など）。

省略可。最適な使用コンテキストまたはドメイン（「会話」、「オーディオブック」、「ニュース」など）。

省略可。声の音色、個性、トーンに関する説明的な概要。

省略可。保存された音声のユーザー指定の表示名（`store = true`）、または事前構築済み音声のカタログ名。

出力専用。カスタム保存音声（`store = true`）または複製された音声キー（`store = false`）の有効期限が切れるタイムスタンプ。カスタム保存済み音声（`store = true`）の場合、この有効期限は、音声が音声合成に使用されるか、`CreateVoice` の `base_voice` として使用されると延長されます。有効期限のない事前構築済みカタログ音声（`"prebuilt"`）の場合は設定されません。

省略可。認識された音声の性別（「女性」、「男性」、「中性」など）。

出力専用。音声の固有識別子。* Google マネージド カスタム音声（`store = true`）の場合、これは接頭辞 `voice_` を含む生成された ID です（例: `voice_abc123def456`）。`GetVoice` と `DeleteVoice` の `name` として `voices/{id}` を渡し、音声合成時に `SpeechConfig.voice_config.voice`（または `SpeechConfig.voice`）に `{id}` を直接渡します。* プリビルド カタログ音声（`ListVoices` によって返される `"prebuilt"`）の場合、これはスピーカー名（`Puck` や `Charon` など）です。 * `store = false` で `CreateVoice` が呼び出された場合は設定されません。

出力専用。クライアント管理の音声レプリケーション キー（接頭辞 `voicekey_` を含む）。`type` が `"replicated"` で `store` が `false` の場合に `CreateVoice` によってのみ返されます。音声合成時にこのキーを `SpeechConfig.voice_config.voice`（または `SpeechConfig.voice`）に渡します。

省略可。プライマリ BCP-47 言語タグ（例: 「en-US」、「fr-FR」）。

省略可。音声の設計または複製に使用されたモデル。`CreateVoice` で省略すると、デフォルトでサポートされている最新の音声設計モデルが使用されます。カスタム音声（`"prompted"` と `"replicated"`）の `CreateVoice`、`GetVoice`、`ListVoices` レスポンスで返されます。`"prebuilt"` 音声の場合は設定されません。作成した音声は、サポートされている任意の TTS 合成モデルで合成できます。

省略可。想定されるペルソナまたはキャラクターのアーキタイプ（「温かくフレンドリー」、「ナレーター」など）。

省略可。ISO 3166-1 alpha-2 または UN M.49 の地理的地域コード（例: 「US」、「GB」、「001」）。

必須。削除するカスタム保存音声のリソース名（例: `voices/voice_abc123def456`）。