Elevenlabs Turbo V2.5 API Documentation

Elevenlabs Turbo V2.5 API Documentation

Playground

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

Features

Turbo V2.5 converts written text into natural, expressive speech with clear pronunciation, smooth pacing, and lively 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
• Multilingual support plus strong English numeral/date reading
• Fine control via similarity and stability sliders
• Speaker Boost for crisper English numbers, times, and measurements

Pricing

Billed by the exact character count of the input text, prorated — no rounding up to 1,000.

• Rate: $0.10 per 1,000 characters ($100 per 1M characters)
• No minimum charge; a 100-character request costs $0.010

How to Use

1. Enter your script in the text field.
2. Choose a voice_id (for example: Gigi, Callum, Alice). Refer to the full catalog in the voice list above.
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. Click Run to synthesize and preview your audio.

Notes

• For steady rhythm, use clear punctuation and split very long text into shorter segments.
• voice_id must be valid; if you see a voice-ID error, select one from the official list.
• Speaker Boost is especially helpful for finance, time, and measurement scripts.

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.5" \
  -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="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 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|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters