Elevenlabs Multilingual V1 API Documentation

Elevenlabs Multilingual V1 API Documentation

Playground

ElevenLabs Multilingual V1 provides natural-sounding multilingual text-to-speech across many languages. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Multilingual V1 turns text into natural, expressive speech across multiple languages. It delivers clean pronunciation, smooth pacing, and controllable tone—great for voiceovers, narrations, learning content, and product videos.

🎧 Key Features

• Multilingual synthesis with automatic accent handling
• Humanlike intonation and timing; clear number/date reading
• Tone controls via similarity and stability
• Speaker boost for crisper English numerals and units
• Large built-in voice library (see the voice list)

💰 Pricing

• $0.10 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 text in the text field.
2. Set voice_id to a built-in voice name (for example: Callum, Alice, Elli). For more options, use the voice list above.
3. Optional controls • similarity: 0–1 (higher = closer to the base voice’s timbre) • stability: 0–1 (higher = more consistent delivery) • use_speaker_boost: improves English number and unit reading
4. Click Run to generate and preview your audio.

📝 Notes

• Works best with clear punctuation and short sentences; split very long text into segments.
• voice_id must match a valid ID, if you see an invalid-voice error, pick one from the voice list.
• use_speaker_boost is especially helpful for English financial, time, and measurement reads.

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/multilingual-v1" \
  -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