Get language target

Full language-target detail. Once the target reports completed, outputs carries the signed download URLs. To learn when that happens, we recommend the project’s webhook_ids subscription rather than polling this endpoint; fetch here when a delivered URL has expired, or to reconcile after an edit.

Path parameters

project_idstringRequired
Identifier of the parent dubbing project.
language_idstringRequired
Identifier of the language target to fetch.

Headers

xi-api-keystringOptional

Response

Successful Response
language_idstring
Unique identifier of the language target.
project_idstring
Identifier of the parent dubbing project.
target_languagestring

BCP-47 language tag this target is dubbed into.

statusenum

Lifecycle status: queued (waiting on the project to be ready, or on a worker), processing while it is being dubbed, completed once its output is available, stale when the transcript changed after the output was produced, or failed.

revisioninteger

Monotonic counter incremented whenever this target’s transcript changes (a source edit affecting it, or an edit to its translation).

created_atstringformat: "date-time"
When the language target was created.
updated_atstringformat: "date-time"
When the language target was last updated.
model_idstring or nullOptional
Dubbing model this target is dubbed with, inherited from the project and not selectable per language.
voice_settingsobject or nullOptional
Voice settings applied to every speaker in this language, or null if the defaults apply.
outputsobject or nullOptional

Signed output URLs; null until the target has produced an output (present once completed, and kept while stale — compare output_revision against revision to tell whether the output is up to date).

output_revisioninteger or nullOptional

The revision the current dubbed output was generated from; equal to revision when up to date, and lower when stale. This is null until a generation has completed.

errorobject or nullOptional

Why this language failed; null unless status is failed, and also null for the few languages that failed before failure reporting was introduced. A code of project_failed means the parent project failed, so read the project for the underlying cause.

warningslist of objectsOptional

Non-fatal conditions raised while dubbing this language, empty when there are none. Reflects the latest generation. Conditions raised while preparing the source are reported on the project instead.

Errors

422
Unprocessable Entity Error