Gemini TTS シリーズ
Google の Gemini 音声合成モデルです。OpenAI 互換の POST /v1/audio/speech で呼び出し、口調やスタイルを自然言語で指定できます。
google/gemini-3.8-flash-ttsgoogle/gemini-3.8-flash-lite-ttsより低い単価すべての TTS モデルはモデルページ を参照してください。エンドポイントの共通パラメータは Audio Speech API を参照してください。
呼び出し例
Python
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")パラメータの値
mp3 が必要な場合は、先に wav を取得してから ffmpeg などのツールで変換してください:ffmpeg -i speech.wav speech.mp3。
所要時間と長文
実測では、約 20 文字の中国語の文で約 3 秒でレスポンスが返りました。約 6000 文字の英語からは約 9 分の音声が生成され、所要時間は約 105 秒、wav ファイルは約 26 MB でした。長文の場合は、クライアントのタイムアウトを 300 秒以上に設定するか、stream_format: "sse" でストリーミング取得してください。
よくあるエラー
その他のエラーは 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"。