ElevenLabs Eleven v3 API, ElevenLabs Dubbing API, ElevenLabs Music API, ElevenLabs Multilingual v2 API: Pricing, Documentation

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.

X-Webhook-URL: https://your-server.com/webhook/callback

Request Parameters - ElevenLabs Eleven v3 TTS generate request

Content Item Types & Limits

Request Headers

Response Handling

Common status codes.

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'elevenlabs-eleven-v3-tts' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "elevenlabs-eleven-v3-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-eleven-v3-tts",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/elevenlabs-eleven-v3-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

{
  "request_id": "elevenlabs-eleven-v3-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-eleven-v3-tts",
  "error": null,
  "output": {
    "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/elevenlabs-eleven-v3-tts_019dxxxx/output.mp3"],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

Status Values

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

1. Send a generate request to the API endpoint
2. Save the request_id from the response
3. Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
4. When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.

X-Webhook-URL: https://your-server.com/webhook/callback

Request Parameters - ElevenLabs Music generate request

Request Headers

Response Handling

Common status codes.

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'elevenlabs-music' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "elevenlabs-music_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-music",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/elevenlabs-music_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

{
  "request_id": "elevenlabs-music_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-music",
  "error": null,
  "output": {
    "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/elevenlabs-music_019dxxxx/output.mp3"],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

Status Values

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

1. Send a generate request to the API endpoint
2. Save the request_id from the response
3. Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
4. When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

Webhook Headers

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/elevenlabs-dubbing/v1/dub' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  -H 'X-Webhook-Mode: terminal' \
  --data-raw '{"source_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/images/input.jpg", "target_lang": "de"}'

Callback Payload (success)

{
  "request_id": "elevenlabs-dubbing_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-dubbing",
  "output": {
    "media_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/elevenlabs-dubbing/019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.mp4",
    "media_type": "video/mp4"
  },
  "duration": 15.86
}

Failure callback shape

{
  "request_id": "elevenlabs-dubbing_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-dubbing",
  "error": "Couldn't extract audio from the downloaded file.",
  "output": null
}

Delivery semantics

• terminal mode (default): one Webhook callback when the request is COMPLETED or ERROR.
• sync mode: a Webhook callback on every poll.
• Callbacks are idempotent on request_id — de-duplicate on it.
• Respond 200 OK within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

Minimum request

Only source_url and target_lang are required. Everything else has a working default.

{
  "source_url": "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3",
  "target_lang": "es"
}

Source Media & Languages

Source requirements

• source_url must be a public http(s) URL reachable without authentication — no signed-header or private-bucket URLs.
• The file must contain an audible speech track. Silent video, music-only audio and files whose audio stream cannot be read are rejected.
• A video source returns dubbed video with the original picture intact (video/mp4). An audio source returns audio (audio/mpeg).

Limits

To dub media longer than 600 seconds, split it into segments and submit each segment separately — or use start_time and end_time to dub only the portion you need.

The length check is best-effort: it depends on reading the duration out of the file at source_url. If that duration cannot be read, the job is not blocked — it is dubbed and billed normally. Keep your sources within 600 seconds rather than relying on the check to stop them.

Processing time

Processing time scales with media length. Measured: about 12 seconds for 15 seconds of audio, and about 22 seconds for 16 seconds of video.

Supported languages

This endpoint runs ElevenLabs dubbing_v1, which supports the 86 languages below. Give the code in target_lang (and optionally in source_lang). Use the base language tag — region-qualified variants such as pt-BR, es-MX or en-GB are not supported:

Request Headers

Response Handling

Error Responses

{
  "request_id": "elevenlabs-dubbing_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-dubbing",
  "error": "Couldn't extract audio from the downloaded file.",
  "output": null
}

A failed dub is reported via the status endpoint (or Webhook) with status: "ERROR", an error message and output: null. The messages you are most likely to see:

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or FAILED/ERROR).

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}

curl 'https://gateway.pixazo.ai/v2/requests/status/elevenlabs-dubbing_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response (video source)

{
  "request_id": "elevenlabs-dubbing_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-dubbing",
  "output": {
    "media_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/elevenlabs-dubbing/019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.mp4",
    "media_type": "video/mp4"
  },
  "duration": 15.86
}

An audio source returns the same envelope with media_type of audio/mpeg and an audio media_url. output.media_url is a Pixazo-hosted URL. The top-level duration is the length of the source media in seconds — it is what the per-minute charge is computed from.

Response Fields

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or FAILED/ERROR (failure).

Typical Workflow

1. POST https://gateway.pixazo.ai/elevenlabs-dubbing/v1/dub with source_url and target_lang; read request_id from the 202 response.
2. Poll GET https://gateway.pixazo.ai/v2/requests/status/{request_id} — or supply X-Webhook-URL on submit and skip polling.
3. When status is COMPLETED, download output.media_url.
4. Keep no more than 3 dubbing jobs in flight at once.

Pricing

Billed at $0.50 per minute of source media, rounded up to the next whole minute. Billing is measured on the source length, not on the length of the output, and a 15-second clip therefore bills one full minute.

Media longer than 600 seconds is rejected before anything is sent to ElevenLabs — the job ends as ERROR on the first status poll and nothing is charged — so the most expensive possible single request is $5.00.

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/elevenlabs-turbo-v2-5/v1/text-to-speech' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"text": "Hello from Pixazo. This is a text to speech demo.", "voice_id": "JBFqnCBsd6RMkjVDRZzb"}'

Callback Payload (success)

{
  "request_id": "elevenlabs-turbo-v2-5_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-turbo-v2-5",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.mp3"
    ],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-08-01T09:14:16.102Z",
  "completed_at": "2026-08-01T09:14:22.870Z"
}

Failure callback shape

{
  "request_id": "elevenlabs-turbo-v2-5_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-turbo-v2-5",
  "error": "Description of the failure"
}

Delivery semantics

• terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
• sync mode: a Webhook callback on each status change.
• Callbacks are idempotent on request_id — de-duplicate on it.
• Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

Voices

32 languages. Use any voice id from your ElevenLabs voice library.

Request Headers

Response Handling

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or ERROR), then download output.media_url.

curl 'https://gateway.pixazo.ai/v2/requests/status/elevenlabs-turbo-v2-5_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "elevenlabs-turbo-v2-5_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-turbo-v2-5",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.mp3"
    ],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-08-01T09:14:16.102Z",
  "completed_at": "2026-08-01T09:14:22.870Z"
}

Response Fields

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Pricing

Billed at $0.05 per 1,000 characters of input text, rounded up to the next whole 1,000. You are charged for the text you submit, not the length of the audio produced.

Failed requests are not billed.

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/elevenlabs-multilingual-v2/v1/text-to-speech' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"text": "Hello from Pixazo. This is a text to speech demo.", "voice_id": "JBFqnCBsd6RMkjVDRZzb"}'

Callback Payload (success)

{
  "request_id": "elevenlabs-multilingual-v2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-multilingual-v2",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.mp3"
    ],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-08-01T09:14:16.102Z",
  "completed_at": "2026-08-01T09:14:22.870Z"
}

Failure callback shape

{
  "request_id": "elevenlabs-multilingual-v2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "elevenlabs-multilingual-v2",
  "error": "Description of the failure"
}

Delivery semantics

• terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
• sync mode: a Webhook callback on each status change.
• Callbacks are idempotent on request_id — de-duplicate on it.
• Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

Voices

29 languages. Use any voice id from your ElevenLabs voice library.

Request Headers

Response Handling

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or ERROR), then download output.media_url.

curl 'https://gateway.pixazo.ai/v2/requests/status/elevenlabs-multilingual-v2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "elevenlabs-multilingual-v2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "elevenlabs-multilingual-v2",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.mp3"
    ],
    "media_type": "audio/mpeg"
  },
  "created_at": "2026-08-01T09:14:16.102Z",
  "completed_at": "2026-08-01T09:14:22.870Z"
}

Response Fields

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Pricing

Billed at $0.10 per 1,000 characters of input text, rounded up to the next whole 1,000. You are charged for the text you submit, not the length of the audio produced.

Failed requests are not billed.