ElevenAPIDubbingLanguage targets

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