Gemini TTS

POST

/v1beta/models/{model_name}:generateContent

gemini-2.5-flash-preview-tts / gemini-2.5-pro-preview-tts

Request

Path Params

Header Params

Body Params application/json

Example

{
  "contents": [
    {
      "parts": [
        {
          "text": "TTS the following conversation between Joe and Jane:Joe: Hows it going today Jane?Jane: Not too bad, how about you?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO"
    ],
    "speechConfig": {
      "multiSpeakerVoiceConfig": {
        "speakerVoiceConfigs": [
          {
            "speaker": "Joe",
            "voiceConfig": {
              "prebuiltVoiceConfig": {
                "voiceName": "Kore"
              }
            }
          },
          {
            "speaker": "Jane",
            "voiceConfig": {
              "prebuiltVoiceConfig": {
                "voiceName": "Puck"
              }
            }
          }
        ]
      }
    }
  },
  "model": "gemini-2.5-flash-preview-tts"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1beta/models/:generateContent' \
--header 'x-goog-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {
          "text": "TTS the following conversation between Joe and Jane:Joe: Hows it going today Jane?Jane: Not too bad, how about you?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO"
    ],
    "speechConfig": {
      "multiSpeakerVoiceConfig": {
        "speakerVoiceConfigs": [
          {
            "speaker": "Joe",
            "voiceConfig": {
              "prebuiltVoiceConfig": {
                "voiceName": "Kore"
              }
            }
          },
          {
            "speaker": "Jane",
            "voiceConfig": {
              "prebuiltVoiceConfig": {
                "voiceName": "Puck"
              }
            }
          }
        ]
      }
    }
  },
  "model": "gemini-2.5-flash-preview-tts"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "audio/L16;codec=pcm;rate=24000",
                            "data": "XXXX"
                        }
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 29,
        "candidatesTokenCount": 92,
        "totalTokenCount": 121,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 29
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "AUDIO",
                "tokenCount": 92
            }
        ]
    },
    "modelVersion": "gemini-2.5-flash-preview-tts",
    "responseId": "pLy7aNKwNsbrz7IPi-LbsQs"
}

Modified at 2025-09-06 04:53:36

URL context

Gemini Image creation interface (gemini-2.0-flash-exp-image-generation)