Gemini TTS API
Gemini TTS Integration Guide
Calling Method
/v1beta/models/{model}:generateContent — this is not the OpenAI-compatible /v1/audio/speech endpoint.Endpoint
POST https://platform.dataeyes.ai/v1beta/models/gemini-3.1-flash-tts-preview:generateContentAuthentication
Authorization: Bearer sk-YOUR_API_KEYcURL Example
Python Example
Response Format
{
"candidates": [
{
"content": {
"parts": [
{
"inlineData": {
"mimeType": "audio/l16; rate=24000; channels=1",
"data": "AAAAAAAAAA...(Base64-encoded PCM audio data)"
}
}
]
}
}
],
"usageMetadata": {
"promptTokenCount": 15,
"candidatesTokenCount": 200,
"totalTokenCount": 215
}
}Response Field Descriptions
| Field | Description |
|---|---|
mimeType | audio/l16; rate=24000; channels=1 — 16-bit PCM, 24kHz sample rate, mono |
data | Base64-encoded raw PCM audio data |
Available Voices
speechConfig.voiceConfig.prebuiltVoiceConfig.voiceName:| Voice Name | Description |
|---|---|
| Kore | Female |
| Charon | Male |
| Fenrir | Male |
| Aoede | Female |
| Puck | Male |
| Leda | Female |
Official Pricing
| Type | Paid Tier (per 1M tokens) |
|---|---|
| Input (text) | $1.00 |
| Output (audio) | $20.00 |
Important Notes
1.
/v1/audio/speech endpoint is not supported2.
3.
responseModalities must be set to ["AUDIO"]; otherwise, text is returned instead of speech4.
5.
streamGenerateContent?alt=sse:POST /v1beta/models/gemini-3.1-flash-tts-preview:streamGenerateContent?alt=sseVerification Record (2026-04-20)
"Hello, welcome to our service. This is a test of text to speech."audio/l16; rate=24000; channels=1