このドキュメントでは、Gemini Live API で合成音声レスポンスと音声検出を構成する方法について説明します。さまざまな HD 音声と言語でレスポンスを構成できます。また、音声アクティビティ検出設定を構成してユーザーがモデルを中断できるようにすることもできます。
言語と音声を設定する
gemini-3.8-live などのライブ音声モデルは、会話中に言語を自然に切り替えることができます。また、システム指示で指定することで、話す言語を制限することもできます。
音声は、すべてのモデルの voice_name フィールドで構成されます。
次のコードサンプルは、言語と音声を構成する方法を示しています。
from google.genai.types import LiveConnectConfig, SpeechConfig, VoiceConfig, PrebuiltVoiceConfig config = LiveConnectConfig( response_modalities=["AUDIO"], speech_config=SpeechConfig( voice_config=VoiceConfig( prebuilt_voice_config=PrebuiltVoiceConfig( voice_name=voice_name, ) ), language_code="en-US", ), )
音声のトーンとアクセントをガイドする
システム指示を使用して音声のトーンとアクセントをガイドすると、Gemini Live API は指示された音声で応答します。たとえば、「フランス語のアクセントのある、ポジティブで明るい声の英語」などです。
サポートされている音声
Gemini Live API は、voice_name フィールドで次の 30 種類の音声オプションをサポートしています。
|
Zephyr -- 明るい Kore -- しっかりした Orus -- しっかりした Autonoe -- 明るい Umbriel -- 気さくな Erinome -- 明瞭な Laomedeia -- 陽気な Schedar -- 落ち着いた Achird -- 友好的な Sadachbia -- 活発な |
Puck -- 陽気な Fenrir -- 興奮しやすい Aoede -- さわやかな Enceladus -- かすれた Algieba -- なめらかな Algenib -- ガラガラ声の Achernar -- やわらかい Gacrux -- 成熟した Zubenelgenubi -- ざっくばらんな Sadaltager -- 聡明な |
Charon - 情報豊富な Leda - 若々しい Callirrhoe - 気さくな Iapetus - 明瞭な Despina - なめらかな Rasalgethi - 情報豊富な Alnilam - しっかりした Pulcherrima - 積極的な Vindemiatrix - 優しい Sulafat - 温かい |
サポートされている言語
すべての Gemini Live API モデルは、次の言語をサポートしています。
| 言語 | BCP-47 コード |
|---|---|
| アラビア語(エジプト) | ar-EG |
| ベンガル語(バングラデシュ) | bn-BD |
| オランダ語(オランダ) | nl-NL |
| 英語(インド) | en-IN と hi-IN のバンドル |
| 英語(アメリカ) | en-US |
| フランス語(フランス) | fr-FR |
| ドイツ語(ドイツ) | de-DE |
| ヒンディー語(インド) | hi-IN |
| インドネシア語(インドネシア) | id-ID |
| イタリア語(イタリア) | it-IT |
| 日本語(日本) | ja-JP |
| 韓国語(韓国) | ko-KR |
| マラーティー語(インド) | mr-IN |
| ポーランド語(ポーランド) | pl-PL |
| ポルトガル語(ブラジル) | pt-BR |
| ルーマニア語(ルーマニア) | ro-RO |
| ロシア語(ロシア) | ru-RU |
| スペイン語(アメリカ) | es-US |
| タミル語(インド) | ta-IN |
| テルグ語(インド) | te-IN |
| タイ語(タイ) | th-TH |
| トルコ語(トルコ) | tr-TR |
| ウクライナ語(ウクライナ) | uk-UA |
| ベトナム語(ベトナム) | vi-VN |
Gemini 3.8 Live でサポートされているその他の言語
上記の言語に加えて、Gemini 3.8 Live(gemini-3.8-live)は次の言語をサポートしています。
| 言語 | BCP-47 コード |
|---|---|
| アフリカーンス語 | af |
| アルバニア語 | sq |
| アムハラ語 | am |
| アルメニア語 | hy |
| アゼルバイジャン語 | az |
| バスク語 | eu |
| ベラルーシ語 | be |
| ブルガリア語 | bg |
| ビルマ語 | my |
| カタロニア語 | ca |
| セブ語 | ceb |
| 中国語(標準語) | cmn |
| クロアチア語 | 時間 |
| チェコ語 | cs |
| デンマーク語 | da |
| エストニア語 | et |
| フィリピン語 | fil |
| フィンランド語 | fi |
| ガリシア語 | gl |
| グルジア語 | ka |
| ギリシャ語 | el |
| グジャラート語 | gu |
| クレオール語(ハイチ) | ht |
| ヘブライ語 | he |
| ハンガリー語 | hu |
| アイスランド語 | = |
| ジャワ語 | jv |
| カンナダ語 | kn |
| コンカニ語 | kok |
| ラオ語 | lo |
| ラテン語 | la |
| ラトビア語 | lv |
| リトアニア語 | lt |
| ルクセンブルク語 | lb |
| マケドニア語 | mk |
| マイティリー語 | mai |
| マラガシ語 | mg |
| マレー語 | ms |
| マラヤーラム語 | ml |
| モンゴル語 | mn |
| ネパール語 | ne |
| ノルウェー語(ブークモール) | nb |
| ノルウェー語(ニーノシク) | nn |
| オディア語 | または |
| パシュト語 | ps |
| ペルシャ語 | fa |
| パンジャブ語 | pa |
| セルビア語 | sr |
| シンド語 | sd |
| シンハラ語 | si |
| スロバキア語 | sk |
| スロベニア語 | sl |
| スワヒリ語 | sw |
| スウェーデン語 | sv |
| ウルドゥー語 | ur |
カスタム音声を使用する
事前構築済みの音声ではなく、Gemini Live API が合成音声レスポンスで複製する音声の短い録音を提供できます。カスタム音声は、voice_config の replicated_voice_config フィールドでセッションごとに構成されます。事前にアップロードやトレーニングを行う必要はありません。
音声サンプルの要件
音声サンプルは、次の仕様を満たしている必要があります。
音声形式: 可変サンプルレートの PCM 音声
s16le(例:audio/pcm;rate=24000)時間: 10 ~ 20 秒。
カスタム音声の録音
音声サンプルを録音する際は、最適な音質を得るために次のヒントを参考にしてください。
自然に話す: アバターを放送局のように聞こえさせたい場合を除き、「ラジオの声」を使用したり、過度に発音したりしないでください。友人に話しかけるように スクリプトを読み上げます
バックグラウンド ノイズを抑える: ファンやエアコンをオフにし、開いている窓を閉めるなどして、バックグラウンド ノイズをできるだけ抑えます。
少し微笑む: 録音中に微笑むと、録音に温かみが加わり、その温かみが複製された音声に加わります。
カスタム音声の推奨スクリプト
カスタム音声を録音するには、次のいずれかのスクリプトを使用することをおすすめします。
音声標準、全体的な品質に最適: 「太陽の光が大気中の雨粒に当たると、雨粒がプリズムの役割を果たして虹を形成します。虹は、白色光をいくつもの美しい色に分割したものなのです。これらの色が形作る長く丸いアーチです。」
ストーリーテラー(感情やダイナミック レンジを捉えるのに最適): 「ほこりまみれの古い本を開いたとき、私は自分の目を疑いました。小さな金色の鍵が木製の床にカチャリと落ちました。「これはどこから来たのか?」私は突然の興奮を感じながら、心の中でつぶやきました。すべてが変わろうとしていました。」
カスタム音声をセットアップする
WebSocket 接続を介して送信する最初の setup ペイロードでカスタム音声を構成します。
import base64 import json import websockets # Load custom voice audio (PCM s16le, e.g., 24kHz) with open("/path/to/your/audio_sample.wav", "rb") as f: wav_b64 = base64.b64encode(f.read()).decode("utf-8") # Setup generation config with custom voice GENERATION_CONFIG = { "response_modalities": ["AUDIO"], "speech_config": { "voice_config": { "replicated_voice_config": { "voice_sample_audio": "VOICE_SAMPLE", "mime_type": "VOICE_MIME_TYPEaudio/pcm;rate=24000", } } }, } # Session setup message SETUP_MESSAGE = { "setup": { "model": "gemini-3.8-live", "generation_config": GENERATION_CONFIG, "system_instruction": { "parts": [{"text": "Your system instruction here"}] }, "input_audio_transcription": {}, "output_audio_transcription": {}, } }
次のように置き換えます。
VOICE_SAMPLE: Base64 でエンコードされた PCM 音声文字列(10 ~ 20 秒のサンプル)。
VOICE_MIME_TYPE: PCM 音声の MIME タイプ(例:
"audio/pcm;rate=24000")。
カスタム音声は、事前構築済みのアバターまたはカスタム アバターと組み合わせることができます。詳細については、ライブアバターを構成するをご覧ください。
音声アクティビティ検出を構成する
音声アクティビティ検出(VAD)により、モデルは人が話しているときを認識できます。これは、ユーザーがいつでもモデルを中断できるようにするため、自然な会話を作成するうえで不可欠です。
VAD が中断を検出すると、進行中の生成はキャンセルされ、破棄されます。クライアントにすでに送信された情報だけがセッション履歴に保持されます。その後、サーバーは中断を報告する BidiGenerateContentServerContent メッセージを送信します。さらに、サーバーは保留中の関数呼び出しを破棄し、キャンセルされた呼び出しの ID を記載した BidiGenerateContentServerContent メッセージを送信します。
Python
config = { "response_modalities": ["audio"], "realtime_input_config": { "automatic_activity_detection": { "disabled": False, # default "start_of_speech_sensitivity": "low", "end_of_speech_sensitivity": "low", "prefix_padding_ms": 20, "silence_duration_ms": 100, } } }