Skip to Content

Gemini TTS シリーズ

Google の Gemini 音声合成モデルです。OpenAI 互換の POST /v1/audio/speech で呼び出し、口調やスタイルを自然言語で指定できます。

よく使うモデル ID(そのままコピーしてください)
Gemini 3.8 Flash TTSgoogle/gemini-3.8-flash-tts
Gemini 3.8 Flash-Lite TTSgoogle/gemini-3.8-flash-lite-ttsより低い単価

すべての TTS モデルはモデルページ を参照してください。エンドポイントの共通パラメータは Audio Speech API を参照してください。

呼び出し例

gemini_tts.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"]) with client.audio.speech.with_streaming_response.create( model="google/gemini-3.8-flash-tts", voice="Kore", input="本日の会議は午後 3 時に変更になりました。時間どおりにご参加ください。", instructions="ニュースを読み上げるように、落ち着いたはっきりとした口調で読んでください。", response_format="wav", ) as resp: resp.stream_to_file("speech.wav")

パラメータの値

ポイントvoice は必須で、Google のボイス名を指定します。出力フォーマットは wav と pcm のみに対応しています。
パラメータ説明
voice必須。Google のボイス名。例:Kore、Puck、Zephyr。全一覧は Gemini 公式ドキュメント · ボイス を参照。OpenAI のボイス名(例:alloy)は使えません
response_formatwav(デフォルト)または pcm。どちらも 24 kHz、16 ビット、モノラル。mp3、opus、aac、flac には非対応
instructions口調、話す速さ、スタイルを自然言語で指定します。例:「明るい口調で」「ゆっくり話して」
language_code言語コード。例:cmn-CN、en-US。省略するとテキストから自動判定されます
stream_formatsse を渡すと音声チャンクをストリーミングで返します。生成しながら再生する用途に適しています

mp3 が必要な場合は、先に wav を取得してから ffmpeg などのツールで変換してください:ffmpeg -i speech.wav speech.mp3。

所要時間と長文

実測では、約 20 文字の中国語の文で約 3 秒でレスポンスが返りました。約 6000 文字の英語からは約 9 分の音声が生成され、所要時間は約 105 秒、wav ファイルは約 26 MB でした。長文の場合は、クライアントのタイムアウトを 300 秒以上に設定するか、stream_format: "sse" でストリーミング取得してください。

よくあるエラー

HTTPエラーメッセージ原文原因対処方法
400voice is required for speech completionvoice を渡していないKore などのボイス名を渡す
400Request contains an invalid argument.ボイス名が存在しない(例:alloy を渡した)Google のボイス名を使う
400unsupported Gemini response_format: mp3対応していないフォーマットwav または pcm に変更する

その他のエラーは Audio Speech API を参照してください。

公式ドキュメント

よくある質問

Gemini TTS の voice には何を指定しますか?

Google のボイス名を指定します。例:Kore、Puck、Zephyr。全一覧は Gemini 公式ドキュメントを参照してください。voice は必須で、OpenAI の alloy などのボイスは使えません。

Gemini TTS で mp3 を出力できますか?

できません。wav と pcm(24 kHz、16 ビット、モノラル)のみに対応しています。mp3 が必要な場合は ffmpeg -i speech.wav speech.mp3 などで変換してください。

Gemini TTS で口調を制御するには?

instructions パラメータで自然言語により指定します。例:「明るい口調で読んで」「ニュースのように落ち着いて」。

Gemini TTS で voice is required エラーが出るのはなぜですか?

Gemini TTS では voice が必須です。例:"voice": "Kore"。

最終更新日