Passer à la navigation

Créer une langue cible de doublage

Ajoute une langue de doublage à un projet et met le doublage en file d’attente.

Cet appel produit l’audio doublé et est facturé par génération. La cible est créée avec le statut queued et démarre dès que le projet est ready, elle peut donc être ajoutée à tout moment après la création du projet. Elle hérite du modèle de doublage du projet et ne peut pas en sélectionner un autre.

Un projet créé avec webhook_ids envoie un événement dubbing_language_completed contenant les URL de téléchargement de sortie. Nous recommandons donc de vous y abonner plutôt que d’interroger cette cible jusqu’à sa finalisation.

Paramètres de chemin

project_idstringRequis
Identifiant du projet de doublage parent.

En-têtes

xi-api-keystringOptionnel

Requête

This endpoint expects an object.
target_languagestringRequis

Balise de langue BCP-47 vers laquelle doubler le projet (par exemple, fr ou es-MX). Elle doit faire partie des langues prises en charge par le modèle de doublage du projet, et une balise incluant une région doit correspondre à l’un des dialectes pris en charge.

voice_settingsobject or nullOptionnel

Paramètres vocaux appliqués à chaque locuteur dans cette langue. Omettez-les pour utiliser les paramètres par défaut.

translationsmap from strings to strings or nullOptionnel

Enterprise uniquement. Traductions facultatives à utiliser à la place de la traduction automatique. Une correspondance entre l’external_id de chaque segment source, ou son id si aucun n’est fourni, et le texte traduit ; chaque segment source doit être couvert exactement une fois. Au maximum 20 000 entrées, pour un total de 4 Mio de texte. Consultez Utiliser votre propre transcription.

Réponse

Réponse réussie

language_idstring
Identifiant unique de la langue cible.
project_idstring
Identifiant du projet de doublage parent.
target_languagestring

Balise de langue BCP-47 de la langue de doublage de cette cible.

statusenum

État du cycle de vie : queued en attente que le projet soit prêt ou qu’un worker soit disponible, processing pendant le doublage, completed lorsque sa sortie est disponible, stale lorsque la transcription a changé après la production de la sortie, ou failed.

Valeurs autorisées:
revisioninteger

Compteur monotone incrémenté à chaque modification de la transcription de cette cible, qu’il s’agisse d’une modification de la source l’affectant ou d’une modification de sa traduction.

created_atstringformat: "date-time"

Date de création de la langue cible.

updated_atstringformat: "date-time"

Date de la dernière mise à jour de la langue cible.

model_idstring or nullOptionnel

Modèle de doublage utilisé pour cette cible, hérité du projet et non sélectionnable par langue.

voice_settingsobject or nullOptionnel

Paramètres vocaux appliqués à chaque locuteur dans cette langue, ou null si les paramètres par défaut s’appliquent.

outputsobject or nullOptionnel

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 nullOptionnel

La revision à partir de laquelle la sortie doublée actuelle a été générée, égale à revision lorsqu’elle est à jour et inférieure lorsqu’elle est stale. Cette valeur est null tant qu’une génération n’est pas terminée.

errorobject or nullOptionnel

Motif de l’échec de cette langue ; valeur null sauf si status est failed, et également null pour les quelques langues qui ont échoué avant l’introduction du signalement des échecs. Le code project_failed signifie que le projet parent a échoué ; consultez donc le projet pour connaître la cause sous-jacente.

warningslist of objectsOptionnel

Conditions non fatales signalées lors du doublage dans cette langue, vide lorsqu’il n’y en a aucune. Reflète la dernière génération. Les conditions signalées lors de la préparation de la source sont indiquées sur le projet.

Erreurs

422
Unprocessable Entity Error