dubbing_project_create
Create and queue a dubbing project for audio or video, with optional target language and webhooks; uses ElevenLabs credits.
Instructions
Create Dubbing Project Spends ElevenLabs credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyterms | No | Key terms to bias transcription and translation toward (for example, product or brand names). At most 1,000 terms; each term at most 50 characters and 5 words; the characters `<>{}[]\` are not allowed. Terms are trimmed and deduplicated. | |
| model_id | No | Dubbing model (`dubbing_v1` or `dubbing_v2`) every language target of this project is dubbed with. Defaults to `dubbing_v2`. Fixed at create time — the source is prepared for this model, so neither the project nor an individual target can change it later. | |
| file_path | No | The source media file to dub: an audio or video file of at most 3 GiB. Provide this or `source_url`, not both. Local path. | |
| reference | No | Optional free-form string (at most 500 characters) to identify the project on your end. Stored and echoed back verbatim; it does not affect the dub. | |
| source_url | No | Public HTTP(S) URL the source media is fetched from server-side, subject to the same size and format limits as an upload. Provide this or `file`, not both. | |
| file_base64 | No | Base64 contents for "file". Use this when the server cannot read your local disk. | |
| webhook_ids | No | IDs of workspace webhooks to notify as this project progresses — the alternative to polling, and what we recommend. Each receives a `dubbing_project_ready` or `dubbing_project_failed` event for the project, and a `dubbing_language_completed` or `dubbing_language_failed` event for every language unde | |
| file_filename | No | Filename to send for "file". Some endpoints infer the audio format from it. | |
| source_language | No | BCP-47 language tag of the source media; must be a language the transcription model supports. Any region or script subtag is ignored, since transcription is per-language. Omit to auto-detect. | |
| target_language | No | Optional shortcut: also create a language target in this BCP-47 language, queued to start once the project is ready — equivalent to creating the project and then creating one language target. Must be one of the [languages the dubbing model supports](https://elevenlabs.io/docs/help-center/product/dub | |
| transcript_path | No | Enterprise only. Optional JSON transcript to use instead of transcribing the source: a `{"segments": [...]}` document, at most 20,000 segments and 4 MiB. See [Bring your own transcript](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript) for the segment fields and | |
| transcript_base64 | No | Base64 contents for "transcript". Use this when the server cannot read your local disk. | |
| transcript_filename | No | Filename to send for "transcript". Some endpoints infer the audio format from it. |