gemini-tts text-to-speech

POST

/v1beta/models/gemini-2.5-pro-preview-tts:generateContent

Official documentation: https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1beta/models/gemini-2.5-pro-preview-tts:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
        "contents": [{
          "parts":[{
            "text": "Say cheerfully: Have a wonderful day!"
          }]
        }],
        "generationConfig": {
          "responseModalities": ["AUDIO"],
          "speechConfig": {
            "voiceConfig": {
              "prebuiltVoiceConfig": {
                "voiceName": "Kore"
              }
            }
          }
        }
}'

Response Example

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "audio/L16;codec=pcm;rate=24000",
                            "data": "iVBORw0KGgoAAAANSUhEUgAAAiEAAAIhCA... (base64)"
                        }
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": null
        }
    ],
    "promptFeedback": {
        "safetyRatings": null
    },
    "usageMetadata": {
        "promptTokenCount": 9,
        "candidatesTokenCount": 51,
        "totalTokenCount": 60,
        "thoughtsTokenCount": 0,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 9
            }
        ]
    },
    "modelVersion": "gemini-2.5-pro-preview-tts",
    "responseId": "nXxoaf7mPM6j_uMPyICzkQo"
}

Modified at 2026-03-06 15:34:51

Imagen Generate Images

Text Embedding