Elevenlabs Turbo V2 API Documentation

Elevenlabs Turbo V2 API Documentation

Playground

ElevenLabs Turbo V2 is a Text-To-Speech model available via WaveSpeedAI, billed at $0.05 per 1000 characters for API requests. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Turbo V2 turns written text into natural-sounding speech with clear pronunciation, smooth pacing, and expressive tone—ideal for voiceovers, narration, tutorials, podcasts, and digital content. It supports a rich library of multi-lingual voices and fast turnaround for production workflows. See the list here.

Key Features

• Fast, expressive synthesis with humanlike prosody
• Multi-language support and robust English number/date reading
• Fine control via similarity and stability sliders
• Speaker Boost for crisper English numerals, times, and measurements
• Works with built-in voices and your custom voice IDs

Pricing

• $0.05 per 1,000 characters
• If the input length is less than 1000 characters, it will be counted as 1000 characters to pay.

How to Use

1. Enter your script in the text field.
2. Set voice_id to a built-in or custom voice (for example: Gigi, Callum, Alice). See the full catalog in the voice list.
3. Optional controls • similarity: 0–1 (higher = closer to the base voice timbre) • stability: 0–1 (higher = more consistent delivery) • use_speaker_boost: improves English number and unit reading
4. Run to synthesize and preview your audio.

Notes

• For the best rhythm, use clear punctuation and split very long text into smaller chunks.
• voice_id must be valid; if you see a voice-ID error, pick one from the official list above.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "text": "A clear example input",
  "voice_id": "Alice",
  "similarity": 1,
  "stability": 0.5,
  "use_speaker_boost": true
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/elevenlabs/turbo-v2" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; 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 type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  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

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters