For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Crée un projet de doublage à partir d'un fichier importé (`file`) ou d'une URL source (`source_url`).
Renvoie le résultat dès que l'enregistrement du projet existe, avant que la source ne soit récupérée : le projet démarre avec l'état `queued` et atteint l'état `ready` lorsque sa source a été transcrite. Ajoutez-y une langue cible pour chaque langue souhaitée ou transmettez `target_language` pour mettre la première en file d'attente ici.
La création d'un projet entraîne une facturation minimale pour une langue : le doublage d'au moins une langue vous est facturé à la création du projet, avant qu'un résultat n'existe. Cette facturation prépaye la première langue cible, la première cible que vous ajoutez ou celle mise en file d'attente via `target_language` l'utilise, et chaque langue supplémentaire est facturée séparément.
La préparation peut prendre plusieurs minutes pour une source longue. Nous vous recommandons donc de transmettre `webhook_ids` afin d'être averti lorsque le projet atteint l'état `ready` ou `failed`, plutôt que de l'interroger régulièrement.
En-têtes
xi-api-keystringOptionnel
Requête
This endpoint expects a multipart form with multiple files.
filefileOptionnel
Le fichier multimédia source à doubler : un fichier audio ou vidéo de 3 Gio maximum. Fournissez celui-ci ou source_url, pas les deux.
source_urlstring or nullOptionnel
URL HTTP(S) publique depuis laquelle le média source est récupéré côté serveur, soumise aux mêmes limites de taille et de format qu’un import. Fournissez cette URL ou file, mais pas les deux.
referencestring or nullOptionnel
Chaîne facultative de forme libre, de 500 caractères maximum, permettant d’identifier le projet de votre côté. Elle est stockée et renvoyée telle quelle, sans incidence sur le doublage.
source_languagestring or nullOptionnel
Balise de langue BCP-47 du média source. Elle doit correspondre à une langue prise en charge par le modèle de transcription. Toute sous-balise de région ou d’écriture est ignorée, car la transcription s’effectue par langue. Omettez-la pour une détection automatique.
model_idenum or string or nullOptionnel
Modèle de doublage, dubbing_v1 ou dubbing_v2, utilisé pour doubler chaque langue cible de ce projet. La valeur par défaut est dubbing_v2. Il est défini à la création : la source est préparée pour ce modèle, et ni le projet ni une cible individuelle ne peuvent ensuite le modifier.
keytermslist of stringsOptionnel
Termes clés pour orienter la transcription et la traduction, par exemple des noms de produits ou de marques. Maximum 1 000 termes ; chaque terme peut compter au plus 50 caractères et 5 mots ; les caractères `<>{}[]\` ne sont pas autorisés. Les termes sont tronqués et dédupliqués. Répétez le champ une fois par terme ou transmettez un seul tableau JSON.
webhook_idslist of stringsOptionnel
ID des webhooks du Workspace à notifier de la progression de ce projet, une alternative à l’interrogation régulière que nous recommandons. Chacun reçoit un événement `dubbing_project_ready` ou `dubbing_project_failed` pour le projet, ainsi qu’un événement `dubbing_language_completed` ou `dubbing_language_failed` pour chaque langue associée. `dubbing_language_completed` contient les URL de téléchargement de la sortie. Trois ID au maximum, chacun déjà configuré dans votre Workspace. Consultez [Webhooks](https://elevenlabs.io/docs/eleven-api/resources/webhooks) pour savoir comment en créer un et vérifier sa signature. Répétez le champ une fois par ID, ou transmettez un seul tableau JSON ou une chaîne séparée par des virgules. La livraison est effectuée au mieux et peut se répéter ; nous vous recommandons donc de traiter les événements de manière idempotente.
target_languagestring or nullOptionnel
Raccourci facultatif : crée également une cible linguistique dans cette langue BCP-47, mise en file d'attente pour démarrer lorsque le projet est prêt. Cela équivaut à créer le projet, puis une cible linguistique. La langue doit figurer parmi les [langues prises en charge par le modèle de doublage](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing), et une balise qualifiée par région doit correspondre à l'un des dialectes pris en charge. Il s'agit de la première cible linguistique ; elle consomme donc la facturation minimale du projet au lieu de s'y ajouter. Son ID est renvoyé dans `language_ids`.
transcriptfileOptionnel
Enterprise uniquement. Transcription JSON facultative à utiliser à la place de la transcription de la source : un document `{"segments": [...]}` comprenant au maximum 20 000 segments et 4 Mio. Consultez [Utiliser votre propre transcription](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript) pour les champs des segments et leurs contraintes. `source_language` est obligatoire lorsqu'une transcription est fournie. Si un segment comporte une `translation`, `target_language` est obligatoire et chaque segment doit en comporter une ; ces traductions initialisent la cible créée via `target_language`, qui ignore alors la traduction automatique.
Réponse
Réponse réussie
project_idstring
Identifiant unique du projet de doublage.
statusenum
État du cycle de vie du projet : queued avant la prise en charge de la source, preparing pendant sa transcription, ready une fois la transcription terminée et les cibles linguistiques prêtes à démarrer, ou failed. Un projet n’est jamais signalé comme processing, cette valeur est réservée aux cibles linguistiques.
Valeurs autorisées:
revisioninteger
Compteur monotone incrémenté à chaque modification de la transcription source, ajout, modification ou suppression d’un segment.
created_atstringformat: "date-time"
Date de création du projet.
updated_atstringformat: "date-time"
Date de la dernière mise à jour du projet.
referencestring or nullOptionnel
La chaîne de forme libre fournie comme reference lors de la création du projet, ou null si vous n’en avez fourni aucune.
source_languagestring or nullOptionnel
Balise de langue BCP-47 du média source (null si détectée automatiquement).
model_idstring or nullOptionnel
Modèle de doublage utilisé pour chaque langue cible de ce projet. Il est défini à la création et ne peut pas être sélectionné par langue.
mediaobject or nullOptionnel
Source media metadata, populated once the source has been fetched and decoded (shortly after create, before the project is ready); null until then.
language_idslist of stringsOptionnelPar défaut []
Identifiants des cibles linguistiques de ce projet. Renseignés lors de la récupération d’un projet unique et à la création lorsque target_language en crée une. Toujours vides dans les réponses de liste ; listez plutôt les cibles linguistiques du projet.
webhook_idslist of stringsOptionnelPar défaut []
ID des webhooks du Workspace notifiés lorsque ce projet et ses langues atteignent l’état ready, completed ou failed.
errorobject or nullOptionnel
Motif de l’échec du projet ; valeur null sauf si status est failed. Également null pour les quelques projets qui ont échoué avant l’introduction du signalement des échecs.
warningslist of objectsOptionnel
Conditions non fatales signalées lors de la préparation de la source, vide lorsqu’il n’y en a aucune. Reflète la dernière préparation. Les conditions signalées lors du doublage dans une langue donnée sont indiquées sur cette langue.
Crée un projet de doublage à partir d’un fichier importé (file) ou d’une URL source (source_url).
Renvoie le résultat dès que l’enregistrement du projet existe, avant que la source ne soit récupérée : le projet démarre avec l’état queued et atteint l’état ready lorsque sa source a été transcrite. Ajoutez-y une langue cible pour chaque langue souhaitée ou transmettez target_language pour mettre la première en file d’attente ici.
La création d’un projet entraîne une facturation minimale pour une langue : le doublage d’au moins une langue vous est facturé à la création du projet, avant qu’un résultat n’existe. Cette facturation prépaye la première langue cible, la première cible que vous ajoutez ou celle mise en file d’attente via target_language l’utilise, et chaque langue supplémentaire est facturée séparément.
La préparation peut prendre plusieurs minutes pour une source longue. Nous vous recommandons donc de transmettre webhook_ids afin d’être averti lorsque le projet atteint l’état ready ou failed, plutôt que de l’interroger régulièrement.
Termes clés pour orienter la transcription et la traduction, par exemple des noms de produits ou de marques. Maximum 1 000 termes ; chaque terme peut compter au plus 50 caractères et 5 mots ; les caractères <>{}[]\ ne sont pas autorisés. Les termes sont tronqués et dédupliqués. Répétez le champ une fois par terme ou transmettez un seul tableau JSON.
ID des webhooks du Workspace à notifier de la progression de ce projet, une alternative à l’interrogation régulière que nous recommandons. Chacun reçoit un événement dubbing_project_ready ou dubbing_project_failed pour le projet, ainsi qu’un événement dubbing_language_completed ou dubbing_language_failed pour chaque langue associée. dubbing_language_completed contient les URL de téléchargement de la sortie. Trois ID au maximum, chacun déjà configuré dans votre Workspace. Consultez Webhooks pour savoir comment en créer un et vérifier sa signature. Répétez le champ une fois par ID, ou transmettez un seul tableau JSON ou une chaîne séparée par des virgules. La livraison est effectuée au mieux et peut se répéter ; nous vous recommandons donc de traiter les événements de manière idempotente.
Raccourci facultatif : crée également une cible linguistique dans cette langue BCP-47, mise en file d’attente pour démarrer lorsque le projet est prêt. Cela équivaut à créer le projet, puis une cible linguistique. La langue doit figurer parmi les langues prises en charge par le modèle de doublage, et une balise qualifiée par région doit correspondre à l’un des dialectes pris en charge. Il s’agit de la première cible linguistique ; elle consomme donc la facturation minimale du projet au lieu de s’y ajouter. Son ID est renvoyé dans language_ids.
Enterprise uniquement. Transcription JSON facultative à utiliser à la place de la transcription de la source : un document {"segments": [...]} comprenant au maximum 20 000 segments et 4 Mio. Consultez Utiliser votre propre transcription pour les champs des segments et leurs contraintes. source_language est obligatoire lorsqu’une transcription est fournie. Si un segment comporte une translation, target_language est obligatoire et chaque segment doit en comporter une ; ces traductions initialisent la cible créée via target_language, qui ignore alors la traduction automatique.
