ElevenLabs V4 Turbo Text to Speech API

elevenlabs/tts/eleven-v4-turbo

ElevenLabs V4 Turbo Text to Speech turns short and long scripts into speech at half the ElevenLabs V4 rate, with inline audio tags and 90+ languages. Keep the same request fields as ElevenLabs V4 and pick MP3, PCM, Opus or 8 kHz telephony audio.

Input

Text

104/5000

Voice

Stability

Similarity Boost

Output Format

Language Code

Apply Text Normalization

Timestamps

Output

Explore more speech models

ElevenLabs V4 Text to Speech ElevenLabs Turbo v2.5 Text to Speech Gemini 3.8 Flash Lite TTS Text to Speech

Examples

Mandarin science lesson snippet

Mandarin science lesson snippet — A clear classroom narration with number normalization turned on.

Bridge guard NPC line

Bridge guard NPC line — A gruff game character who turns playful by the last line.

ElevenLabs V4 Turbo Text to Speech API

Generate speech with the API

Submit a script, keep the returned task_id, and retrieve the completed audio through the task status endpoint.

Authenticate your request

Send your Vidgo API key in the Authorization header using Bearer authentication.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer YOUR_API_KEY

Submit the script

Send model and input as JSON. The example below uses the same script and voice as the first audio sample.

Request example

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "elevenlabs/tts/eleven-v4-turbo",
  "input": {
    "text": "Welcome back, Maya. Your two oat lattes are ready at the front counter. [cheerfully] Enjoy your morning!",
    "voice": "Sarah",
    "stability": 0.6,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto",
    "timestamps": false,
    "language_code": "en"
  }
}
JSON
)

RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
  printf 'API error: %s
' "$RESPONSE" >&2
  exit 1
fi
printf '%s
' "$RESPONSE"

Follow the task

Query the returned task_id until status is finished or failed.

Status endpoint

GET https://api.vidgo.ai/api/generate/status/{task_id}

Keep the task_id from submission. Check its status and read the generated files when it finishes.

not_startedrunningfinishedfailed

Submission response

{
  "code": 200,
  "data": {
    "task_id": "Q0VR50Z9WSL5RV2G",
    "status": "not_started",
    "created_time": "2026-11-05T07:12:48"
  }
}

Completed response

{
  "code": 200,
  "data": {
    "task_id": "Q0VR50Z9WSL5RV2G",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/eleven-v4-turbo/v2/01/speech-01.mp3",
        "file_type": "audio",
        "file_name": "speech-01.mp3"
      }
    ],
    "created_time": "2026-11-05T07:12:48",
    "error_message": null,
    "progress": 100
  }
}

Read the audio files

Use the audio file_url for playback or download. With timestamps enabled, download the timing file from its separate files entry.

Read the audio files

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "elevenlabs/tts/eleven-v4-turbo",
  "input": {
    "text": "Welcome back, Maya. Your two oat lattes are ready at the front counter. [cheerfully] Enjoy your morning!",
    "voice": "Sarah",
    "stability": 0.6,
    "similarity_boost": 0.75,
    "output_format": "mp3_44100_128",
    "apply_text_normalization": "auto",
    "timestamps": false,
    "language_code": "en"
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
  printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
  if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
    printf 'Timed out after 600 seconds
' >&2
    exit 1
  fi
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
  BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
  if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
    printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
    exit 1
  fi

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep "$POLL_DELAY"
      if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Request parameters

Place speech controls inside input; keep model and callback_url at the top level.

Field	Type	Required	Default	Description
model	string	Yes	—	Use elevenlabs/tts/eleven-v4-turbo to select this speech model.
input	object	Yes	—	Contains the script and the speech controls listed below.
input.text	string	Yes	—	The script to speak, 1–5,000 characters as sent, including spaces, line breaks and audio tags. Add tags such as [whispers] or [excited] where the delivery should change.
input.voice	string	No	Rachel	An ElevenLabs voice name or voice ID. Pick a suggested preset such as Rachel, George or Lily, or paste the ID of another ElevenLabs voice.
input.stability	number	No	0.5	A value from 0 to 1. Lower values allow more expressive variation; higher values keep the read steadier from line to line.
input.similarity_boost	number	No	0.75	A value from 0 to 1 that sets how closely the speech follows the character of the selected voice.
input.output_format	string	No	mp3_44100_128	Codec, sample rate and bitrate of the returned audio: MP3 at 22.05 or 44.1 kHz, raw PCM from 8 to 48 kHz, µ-law and A-law at 8 kHz for telephony, or Opus at 48 kHz. Values: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192.
input.apply_text_normalization	string	No	auto	auto decides when to spell out numbers, dates and symbols, on always normalizes them, and off reads text that you have already written out for speech.
input.timestamps	boolean	No	false	Set to true to receive timing data for the speech as an additional file next to the audio.
input.language_code	string	No	—	Optional ISO 639-1 code, such as en, zh or es, to name the spoken language. Leave it empty to let the model detect the language from the script.
callback_url	string	No	—	Optional HTTP or HTTPS URL for task notifications. Include it at the top level of the request.

Response fields

Submission identifies the task. Status responses report progress toward the completed audio.

Field	Type	Description
code	integer	Response code. A successful response uses 200 or 0.
data.task_id	string	Task identifier used to query status.
data.status	string	Task state: not_started, running, finished, or failed.
data.created_time	string	Task creation time returned by the service.
data.files	array	Generated files. Read audio entries for speech and other entries for requested attachments.
data.files[].file_url	string	URL used to play or download a generated file.
data.files[].file_type	string	audio for speech; other for attachments such as the timing file.
data.files[].file_name	string	File name, when returned.
data.error_message	string \| null	Error details when a task fails.

Task lifecycle

Use the task state to decide when to check again or read the result.

not_started
The task has been accepted and is waiting to start.
running
Speech generation is in progress. Continue checking the same task.
finished
Generation is complete. Read files for the audio and requested attachments.
failed
Generation failed. Read error_message before deciding whether to submit a new request.

Handle results and interruptions

Keep the current task identifierIf a status request is interrupted, query the same task_id again to recover its latest state.
Match each file to its purposeUse file_type to separate speech from attachments. Read the returned file_url and file_name for each download.
Inspect a failed taskWhen status is failed, read error_message and review the script and settings before submitting another generation.

Speech specifications

Item	Value	Description
Task	Text to Speech	Generate speech from a script and one voice.
Text length	1–5,000 characters	Counted as sent, including spaces and tags.
Languages	90+	Detected from the script or set with language_code.
Output formats	19	MP3, PCM, µ-law, A-law and Opus; default mp3_44100_128.
Price	$0.04 / 1K characters	8 credits per 1,000 characters.
Timing data	Optional	Returned as an extra file when timestamps is true.

View the ElevenLabs V4 Turbo Text to Speech API docs

ElevenLabs V4 Turbo Text to Speech

ElevenLabs V4 Turbo Text to Speech is the faster, lower-cost member of the ElevenLabs V4 generation, released alongside ElevenLabs V4 in September 2026. ElevenLabs positions it for interactive apps and high-volume voice prompts. It keeps audio tags, 90+ languages and the same voice controls as ElevenLabs V4, and costs 8 credits per 1,000 characters on Vidgo, so notifications, lessons and dialogue lines stay inexpensive at scale.

Why choose ElevenLabs V4 Turbo?

Half the ElevenLabs V4 rateAt 8 credits ($0.04) per 1,000 characters, a full 5,000-character request costs 40 credits, which suits large batches of prompts and lessons.
Same request as ElevenLabs V4Text, voice, stability, similarity boost, format, normalization, timestamps and language code work the same way. Switch between the two by changing model.
Audio tags in short linesAdd [cheerfully] or [laughs] to a one-line notification or an NPC reply to give it character without writing longer scripts.
Telephony and app-ready formatsReturn 8 kHz µ-law or A-law for IVR prompts, Opus for apps, or MP3 and PCM for video and editing tools.

Speech parameters

Parameter	Requirement	What it controls
text	Required	The script to speak, 1–5,000 characters as sent, including spaces, line breaks and audio tags. Add tags such as [whispers] or [excited] where the delivery should change.
voice	Optional	An ElevenLabs voice name or voice ID. Pick a suggested preset such as Rachel, George or Lily, or paste the ID of another ElevenLabs voice. Default`Rachel`
stability	Optional	A value from 0 to 1. Lower values allow more expressive variation; higher values keep the read steadier from line to line. Default`0.50–1`
similarity_boost	Optional	A value from 0 to 1 that sets how closely the speech follows the character of the selected voice. Default`0.750–1`
output_format	Optional	Codec, sample rate and bitrate of the returned audio: MP3 at 22.05 or 44.1 kHz, raw PCM from 8 to 48 kHz, µ-law and A-law at 8 kHz for telephony, or Opus at 48 kHz. Default`mp3_44100_128mp3_22050_32mp3_44100_32mp3_44100_64mp3_44100_96mp3_44100_192pcm_8000pcm_16000pcm_22050pcm_24000pcm_44100pcm_48000ulaw_8000alaw_8000opus_48000_32opus_48000_64opus_48000_96opus_48000_128opus_48000_192`
apply_text_normalization	Optional	auto decides when to spell out numbers, dates and symbols, on always normalizes them, and off reads text that you have already written out for speech. Default`autoonoff`
timestamps	Optional	Set to true to receive timing data for the speech as an additional file next to the audio. Default`falsetrue`
language_code	Optional	Optional ISO 639-1 code, such as en, zh or es, to name the spoken language. Leave it empty to let the model detect the language from the script.

Create speech in four steps

Write the scriptEnter up to 5,000 characters in Text and add an audio tag where the delivery changes.
Pick a voiceType or select a Voice, then start with Stability 0.5 and Similarity Boost 0.75.
Choose format and languageSet Output Format for your destination, add a Language Code if needed and enable Timestamps for captions.
Run and listenCheck the cost on the Run button, select Run and download the audio when the task finishes.

Character-based pricing

ElevenLabs V4 Turbo Text to Speech costs $0.04, or 8 credits, per 1,000 characters of text. Every character you send counts, including spaces, line breaks and audio tags; the other settings do not change the price.

Text length	Cost	Calculation
100 characters	$0.004 · 0.8 credits	100 × 8 / 1000 = 0.8 credits
1,000 characters	$0.04 · 8 credits	1000 × 8 / 1000 = 8 credits
5,000 characters	$0.20 · 40 credits	5000 × 8 / 1000 = 40 credits

Where it fits

App and kiosk promptsVoice order updates, onboarding steps and reminders at a low per-character cost.
Phone menus and IVRExport ulaw_8000 or alaw_8000 for telephony systems that expect 8 kHz audio.
E-learning snippetsNarrate short lesson steps with text normalization turned on for numbers and units.
Game barks and NPC linesGenerate many short character lines with tags such as [gruff] or [laughs].

Pro tips

Start with ElevenLabs V4 Turbo for drafts and bulk prompts, and move key scenes to ElevenLabs V4 by changing only model.
Keep notification text short and natural; one tag per line is usually enough.
Turn on text normalization for prices, times and order numbers, then listen to one sample before batching.
Choose ulaw_8000 or alaw_8000 only for phone systems; browsers play MP3 and Opus more easily.

Prepare audio for your workflow

PCM, µ-law and A-law files are raw audio without a WAV header. Wrap or convert them in your audio tool if a player needs a container.
With timestamps enabled, read every item in files: the audio and the timing file are returned as separate entries.

Explore more speech models

ElevenLabs V4 Text to SpeechThe most expressive V4 model for narration and character scenes.

ElevenLabs Turbo v2.5 Text to Speech preview

ElevenLabs Turbo v2.5 Text to SpeechThe earlier ElevenLabs Turbo speech model.

Gemini 3.8 Flash Lite TTS Text to Speech preview

Gemini 3.8 Flash Lite TTS Text to SpeechLow-cost speech with optional two-speaker dialogue.

ElevenLabs V4 Turbo Text to Speech API frequently asked questions

What is the ElevenLabs V4 Turbo Text to Speech API?

ElevenLabs V4 Turbo Text to Speech is an ElevenLabs model for fast, cost-efficient speech generation. It turns scripts into speech in 90+ languages with inline audio tags, the same voice controls as ElevenLabs V4 and 19 output formats. ElevenLabs built it as the low-latency member of the V4 generation, and it keeps the selected voice consistent across short prompts and longer passages. You can call it programmatically or try it from the playground above.

Should I choose ElevenLabs V4 Turbo or ElevenLabs V4?

Choose ElevenLabs V4 Turbo for prompts, lessons and large batches where cost matters: it costs 8 credits ($0.04) per 1,000 characters. ElevenLabs V4 costs 16 credits and is positioned by ElevenLabs as its most emotive model for narration and character scenes. Both take the same fields, so you can compare them by changing model.

How do audio tags work in ElevenLabs V4 Turbo?

Write a direction in square brackets inside Text, such as [whispers], [laughs] or [excited], right before the words it should shape. Tags count toward the character total. Start with one tag per phrase and listen before adding more.

How long can a ElevenLabs V4 Turbo script be?

Each request accepts 1–5,000 characters, counted exactly as sent, including spaces, line breaks and tags. Split longer scripts at paragraph or scene breaks and reuse the same voice settings for every part.

Which output formats does ElevenLabs V4 Turbo return?

Output Format offers 19 values: MP3 at 22.05 or 44.1 kHz from 32 to 192 kbps, raw PCM from 8 to 48 kHz, µ-law and A-law at 8 kHz, and Opus at 48 kHz from 32 to 192 kbps. The default is mp3_44100_128.

Can I use my own ElevenLabs voice with ElevenLabs V4 Turbo?

Voice accepts an ElevenLabs voice name or voice ID. Use a suggested preset such as Rachel or George, or paste the ID of another ElevenLabs voice and keep Stability and Similarity Boost fixed while you compare takes.

Can ElevenLabs V4 Turbo return timestamps for subtitles?

Yes. Set timestamps to true and the finished task includes a timing file as an additional item in files, next to the audio. Use it to place captions or align edits.

How much does ElevenLabs V4 Turbo cost per request?

ElevenLabs V4 Turbo costs 8 credits ($0.04) per 1,000 characters. A 1,000-character script costs 8 credits and a full 5,000-character request costs 40 credits ($0.20).