curl -X POST 'https://api.elevenlabs.io/v1/dubbing/project/project-id/language' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "target_language": "example-target-language",
  "voice_settings": {
    "cloning_strength": 7
  },
  "translations": {}
}'

# POST /v1/dubbing/project/{project_id}/language (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Create Dubbing Language Target

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/dubbing/project/project-id/language' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"target_language":"example-target-language","voice_settings":{"cloning_strength":7}}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| project_id | path | string | Yes | Identifier of the parent dubbing proj... |
| target_language | body | string | Yes | BCP-47 language tag to dub the projec... |
| voice_settings | body | object | No | Voice settings applied to every speak... |
Other params: translations

## Response (200 OK)
{"language_id":"string","project_id":"string"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

POST /v1/dubbing/project/{project_id}/language — ElevenLabs API

ElevenLabs API

Create Dubbing Language Target

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/dubbing/project/project-id/language' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "target_language": "example-target-language",  "voice_settings": {    "cloning_strength": 7  },  "translations": {}}'

Parameters

Name	In	Type	Required	Description
project_id	path	string	Yes	Identifier of the parent dubbing project.
target_language	body	string	Yes	BCP-47 language tag to dub the project into (for example, `fr` or `es-MX`). Must be one of the [languages the project's dubbing model supports](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing), and a region-qualified tag must be one of the supported dialects.
voice_settings	body	object	No	Voice settings applied to every speaker in this language. Omit to use the defaults.
translations	body	object	No	Enterprise only. Optional translations to use instead of machine translation. A map from each source segment's `external_id` (or its `id`, if you supplied none) to the translated text; every source segment must be covered exactly once. At most 20,000 entries, totaling at most 4 MiB of text. See [Bring your own transcript](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript).

Response 200 OK

{
  "language_id": "string",
  "project_id": "string",
  "target_language": "string",
  "status": "queued",
  "model_id": "string",
  "voice_settings": {
    "cloning_strength": 7
  },
  "outputs": {
    "lossless_audio": "string",
    "subtitles": "string"
  },
  "revision": 0,
  "output_revision": 0,
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  },
  "warnings": [
    {
      "type": "string",
      "speaker_ids": [
        "string"
      ],
      "message": "string"
    }
  ],
  "created_at": "2026-09-03T00:00:00Z",
  "updated_at": "2026-09-03T00:00:00Z"
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.