Sign in
Dubbing

Create Dubbing Project

Create a dubbing project from an uploaded file (file) or a source URL (source_url).

Returns as soon as the project record exists, before the source has been fetched: the project starts queued and reaches ready once its source has been transcribed. Add a language target to it for each language you want, or pass target_language to queue the first one here.

Creating a project incurs a minimum charge of one language: you are charged for at least one language's dubbing when the project is created, before any output exists. This charge prepays the first language target — the first target you add, or the one queued via target_language, consumes it — and each additional language is charged separately.

Preparation can take minutes on a long source, so we recommend passing webhook_ids to be notified when the project turns ready or failed, rather than polling for it.

post/v1/dubbing/project

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

project_idstring required

Unique identifier of the dubbing project.

status'queued' | 'preparing' | 'processing' | 'ready' | 'failed' required

Lifecycle status of the project: queued before the source is picked up, preparing while it is transcribed, ready once transcription is done and language targets can start, or failed. A project is never reported as processing — that value belongs to language targets.

referencestring nullable

The free-form string you supplied as reference when creating the project, or null if you supplied none.

source_languagestring nullable

BCP-47 language tag of the source media (null if auto-detected).

model_idstring nullable

Dubbing model every language target of this project is dubbed with. Fixed at create time and not selectable per language.

language_idsstring[]

Identifiers of the language targets under this project. Populated when a single project is fetched, and on create when target_language creates one. Always empty in list responses — list the project's language targets instead.

webhook_idsstring[]

IDs of the workspace webhooks notified as this project and its languages reach ready, completed, or failed.

revisioninteger required

Monotonic counter incremented whenever the source transcript is edited (segment add/edit/delete).

created_atstring date-time required

When the project was created.

updated_atstring date-time required

When the project was last updated.

Changes