Skip to Content
ModèlesGemini TTS

Famille Gemini TTS

Les modèles de synthèse vocale Gemini de Google s’appellent via l’endpoint compatible OpenAI POST /v1/audio/speech ; le ton et le style se décrivent en langage naturel.

ID de modèle courants (à copier tels quels)
Gemini 3.8 Flash TTSgoogle/gemini-3.8-flash-tts
Gemini 3.8 Flash-Lite TTSgoogle/gemini-3.8-flash-lite-ttsPrix unitaire plus bas

Tous les modèles TTS figurent sur la page des modèles . Les paramètres communs de l’endpoint sont décrits dans Audio Speech API.

Exemples d’appel

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="La réunion est déplacée à 15 heures, merci à tous de venir à temps.", instructions="Lis sur un ton posé et clair, comme un présentateur de journal.", response_format="wav", ) as resp: resp.stream_to_file("speech.wav")

Valeurs des paramètres

L'essentielvoice est obligatoire et prend un nom de voix Google ; seuls les formats de sortie wav et pcm sont pris en charge.
ParamètreDescription
voiceObligatoire, nom de voix Google, par exemple Kore, Puck ou Zephyr. La liste complète figure dans la documentation officielle de Gemini · Voix . Les noms de voix d’OpenAI (par exemple alloy) ne sont pas utilisables
response_formatwav (par défaut) ou pcm, tous deux en 24 kHz, 16 bits, mono. mp3, opus, aac et flac ne sont pas pris en charge
instructionsDécrit en langage naturel le ton, le débit et le style, par exemple « sur un ton enjoué » ou « ralentis le débit »
language_codeCode de langue, par exemple cmn-CN ou en-US ; détecté automatiquement à partir du texte s’il est omis
stream_formatAvec sse, l’audio est renvoyé en fragments par streaming, ce qui permet de le lire au fur et à mesure de sa génération

Pour obtenir du mp3, récupérez d’abord le wav puis convertissez-le avec un outil comme ffmpeg : ffmpeg -i speech.wav speech.mp3.

Latence et textes longs

Lors de nos tests, une phrase d’environ 20 caractères chinois est renvoyée en 3 secondes environ. Un texte anglais d’environ 6 000 caractères a produit environ 9 minutes d’audio en 105 secondes environ, pour un fichier wav d’environ 26 Mo ; pour les textes longs, réglez le délai d’attente du client sur 300 secondes ou plus, ou récupérez l’audio en streaming avec stream_format: "sse".

Erreurs courantes

HTTPMessage d’erreurCauseSolution
400voice is required for speech completionvoice absentPassez un nom de voix, par exemple Kore
400Request contains an invalid argument.Le nom de voix n’existe pas, par exemple alloyUtilisez un nom de voix Google
400unsupported Gemini response_format: mp3Format non pris en chargeUtilisez wav ou pcm

D’autres erreurs sont décrites dans Audio Speech API.

Documentation officielle

FAQ

Que mettre dans voice pour Gemini TTS ?

Un nom de voix Google, par exemple Kore, Puck ou Zephyr ; la liste complète figure dans la documentation officielle de Gemini. voice est obligatoire, et les voix d'OpenAI comme alloy ne sont pas utilisables.

Gemini TTS peut-il produire du mp3 ?

Non, seuls wav et pcm (24 kHz, 16 bits, mono) sont pris en charge. Pour obtenir du mp3, convertissez vous-même le fichier, par exemple avec ffmpeg -i speech.wav speech.mp3.

Comment contrôler le ton de Gemini TTS ?

Décrivez-le en langage naturel dans le paramètre instructions, par exemple « lis sur un ton enjoué » ou « posé comme un présentateur de journal ».

Gemini TTS renvoie voice is required ?

Gemini TTS exige le paramètre voice, par exemple "voice": "Kore".

Dernière mise à jour le