Seedream 5.0 Pro jest już LIVE | Wypróbuj w Generator obrazów →

Gemini 3.1 Flash Text to Speech

google /

Gemini 3.1 Flash Text to Speech generates expressive multi-speaker audio from text, with natural voices and multilingual language control for dialogue, narration, localization, and AI voice workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-audio
Wejście

Bezczynny

$0.15za uruchomienie·~66 / $10

PrzykładyZobacz wszystkie

Powiązane modele

README

Gemini 3.1 Flash Text-to-Speech

Gemini 3.1 Flash Text-to-Speech turns scripts and labelled dialogue into expressive spoken audio. Assign a distinct voice to each speaker and generate one natural, multilingual audio track for narration, conversations, and voiceover workflows.

Why Choose This?

  • Expressive speech generation
    Create natural pacing, tone, and delivery from written scripts.

  • Multi-speaker dialogue
    Assign different voices to up to two named speakers in one generation.

  • Multilingual voice output
    Select the language and locale that match the script for stronger pronunciation.

  • Voice preset control
    Choose from a library of voice presets for narration, dialogue, announcements, and character reads.

  • Standard audio output
    Generated audio is returned as a URL in the standard WaveSpeed prediction response.

Parameters

ParameterRequiredDescription
textYesScript or dialogue to synthesize. Use each speaker name exactly as configured in speakers.
languageYesLanguage and locale spoken in the generated audio.
speakersYesOne or two speaker entries. Each entry includes a speaker name and voice preset.

How to Use

  1. Write your script — Use a consistent Speaker: dialogue format, such as Narrator: Welcome to the show.
  2. Choose a language — Select the language and locale for the spoken audio.
  3. Add speakers — Add each speaker label used in the script, then choose a voice preset.
  4. Submit — Generate the spoken audio and retrieve the output URL.

Pricing

Pricing is $0.15 per 1,000 characters of input text, rounded up to the next 1,000 characters.

Text LengthPrice
1-1,000 characters$0.15
1,001-2,000 characters$0.30
2,001-3,000 characters$0.45
3,001-5,000 characters$0.75
5,001-8,000 characters$1.20

Best Use Cases

  • Dialogue generation — Create conversations with different named voices.
  • Narration and voiceover — Produce spoken scripts for videos, presentations, and explainers.
  • Podcasts and audio stories — Generate host or character dialogue from structured scripts.
  • Multilingual content — Create localized speech with language-aware voice output.
  • Product demos — Turn scripted product messaging into polished audio.

Pro Tips

  • Make every speaker label in the script exactly match the corresponding speaker entry.
  • Keep punctuation clear to guide pauses, emphasis, and delivery.
  • Use one speaker for narration and two speakers for dialogue.
  • Match the selected language to the language used in the script.
  • Split long scripts into logical sections for more consistent pacing.
Uwaga:Ta strona korzysta z modeli AI udostępnianych przez podmioty trzecie.

Gemini 3.1 Flash Text To Speech API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/google/gemini-3.1-flash/text-to-speech with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Gemini 3.1 Flash Text To Speech below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "text": "A clear example input",
    "language": "English (United States)",
    "speakers": [
        {
            "speaker": "example",
            "voice": "Achernar"
        }
    ]
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/google/gemini-3.1-flash/text-to-speech" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "$TASK" | jq -r '.urls.get // empty')
if [ -z "$RESULT_URL" ]; then
  RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "$STATUS" >&2; exit 1 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/google/gemini-3.1-flash/text-to-speech";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "text": "A clear example input",
        "language": "English (United States)",
        "speakers": [
                {
                        "speaker": "example",
                        "voice": "Achernar"
                }
        ]
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = task.urls?.get ||
  `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout"].includes(result.status)) throw new Error(JSON.stringify(result));
  if (!["created", "processing"].includes(result.status)) throw new Error("Unexpected status: " + result.status);
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "text": "A clear example input",
    "language": "English (United States)",
    "speakers": [
        {
            "speaker": "example",
            "voice": "Achernar"
        }
    ]
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/google/gemini-3.1-flash/text-to-speech", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = task.get("urls", {}).get("get") or f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout"}:
        raise RuntimeError(result)
    if status not in {"created", "processing"}:
        raise RuntimeError(f"Unexpected status: {status}")
    time.sleep(2)

Gemini 3.1 Flash Text To Speech API — Frequently asked questions

What is the Gemini 3.1 Flash Text To Speech API?

Gemini 3.1 Flash Text To Speech is a Google model for audio generation, exposed as a REST API on WaveSpeedAI. Gemini 3.1 Flash Text to Speech generates expressive multi-speaker audio from text, with natural voices and multilingual language control for dialogue, narration, localization, and AI voice workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Gemini 3.1 Flash Text To Speech API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/google/google-gemini-3.1-flash-text-to-speech.

How much does Gemini 3.1 Flash Text To Speech cost per run?

Gemini 3.1 Flash Text To Speech starts at $0.15 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Gemini 3.1 Flash Text To Speech accept?

Key inputs: `language`, `speakers`, `text`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/google/google-gemini-3.1-flash-text-to-speech.

How do I get started with the Gemini 3.1 Flash Text To Speech API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Gemini 3.1 Flash Text To Speech outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Google). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

Gemini 3.1 Flash Text to Speech | WaveSpeedAI