> ## Documentation Index > Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Aperçu > Traduction et doublage vidéo/audio L’API Traduction et doublage localise le contenu vidéo et audio dans une autre langue en traduisant le contenu parlé et en générant une piste de doublage. Vous pouvez éventuellement ajouter des sous-titres traduits, synchroniser la vidéo avec l’audio traduit ou créer un projet modifiable dans l’application web Vozo. Selon vos paramètres, l’API renvoie la vidéo et/ou l’audio traduits, un fichier de sous-titres SRT et une URL de projet. ## Entrées ### Médias et langues | Champ | Valeurs | Exigence | Description | | - | - | - | - | | `media_type` | `video`, `audio` | Obligatoire | Indique si le média d’entrée est un fichier vidéo ou audio. | | `media_url` | URL du média accessible publiquement | Obligatoire | URL du média d’entrée. La durée maximale prise en charge est de 2 heures. | | `source_language` | `auto` ou un code de langue pris en charge | Obligatoire | Langue source du média d’entrée. Utilisez `auto` pour la détecter automatiquement. | | `target_language` | Code de langue pris en charge, avec paramètres régionaux facultatifs | Obligatoire | Langue cible pour la traduction et le doublage. | ### Sources du texte des sous-titres Utilisez ces champs si vous avez du texte de sous-titres original ou traduit à fournir. Sinon, vous pouvez ignorer cette section. | Champ | Valeurs | Exigence | Description | | - | - | - | - | | `subtitle_url` | URL SRT accessible publiquement | Facultatif ; associé à `subtitle_usage_type` ; forfait Studio ou supérieur requis | Utilise directement le texte du fichier SRT fourni comme texte source ou comme texte traduit final, selon la valeur de `subtitle_usage_type`, au lieu de le générer par reconnaissance vocale ou traduction. Mutuellement exclusif avec `ocr_text_box`. | | `subtitle_usage_type` | `original`, `final_translated` | Facultatif ; associé à `subtitle_usage_type` ; forfait Studio ou supérieur requis | Détermine comment le texte SRT est utilisé : `original` l’utilise comme texte source, tandis que `final_translated` l’utilise comme texte traduit final. N’a pas de valeur par défaut. | | `ocr_text_box` | `{ x, y, width, height }` | Facultatif ; vidéo uniquement ; forfait Studio ou supérieur requis | Détecte les sous-titres intégrés dans la zone spécifiée du texte à l'écran et utilise le texte détecté comme texte source. Prend en charge uniquement le chinois et l’anglais ; le texte détecté ne peut pas être utilisé comme texte traduit final. Les coordonnées sont normalisées de 0 à 1, avec l’origine en haut à gauche. Mutuellement exclusif avec `subtitle_url`. | ### Traduction et doublage Utilisez ces champs pour personnaliser les modèles, paramètres ou exigences de traduction et de doublage. Sinon, vous pouvez ignorer cette section. | Champ | Valeurs | Exigence | Description | | - | - | - | - | | `speaker_number` | `{ min, max }` | Facultatif | Spécifie la plage attendue du nombre d’intervenants. `min` doit être au moins égal à 1 et `max` ne peut pas dépasser 35. Omettez ce champ pour une détection automatique. | | `voice_model` | `auto`, `real`, `native` | Facultatif | Sélectionne le modèle de clonage vocal utilisé pour le doublage. La valeur par défaut est `auto` : `auto` sélectionne automatiquement le meilleur modèle pour votre contenu ; `real` utilise VoiceREAL pour préserver l’émotion et l’accent de la voix d’origine ; `native` utilise VoiceNATIVE pour offrir un accent plus naturel dans la langue cible. | | `selected_voice_id` | Chaîne | Facultatif | Utilise une voix spécifique de la bibliothèque vocale dans l’application web Vozo pour le doublage. Lorsque ce champ est fourni, il remplace `voice_model` : l’API ignore le clonage vocal automatique et utilise la voix sélectionnée pour générer l’audio doublé.
Image | | `align_video` | Booléen | Facultatif ; vidéo uniquement | Lorsqu’il est défini sur `true`, ajuste automatiquement la vitesse de la vidéo afin que l’audio traduit et la vidéo restent synchronisés du début à la fin. La valeur par défaut est `false`. Définissez-le sur `false` si l’audio traduit sera utilisé comme piste audio supplémentaire sur YouTube. | | `glossary_ids` | Tableau de jusqu’à 3 ID | Facultatif ; forfait Studio ou supérieur requis | Applique les glossaires créés dans l’application web Vozo pour garantir la cohérence de la terminologie. Glossary Pn | | `user_prompt` | Chaîne | Facultatif | Fournit des instructions de traduction ou de doublage, telles que les préférences de ton, de style ou de terminologie. | ### Sortie des sous-titres Utilisez ces champs si vous souhaitez ajouter des sous-titres traduits à la vidéo ou effacer et remplacer les sous-titres existants. Sinon, vous pouvez ignorer cette section. | Champ | Valeurs | Exigence | Description | | - | - | - | - | | `subtitle_mode` | `none`, `add`, `replace` | Facultatif | Contrôle le rendu des sous-titres : ne pas afficher de sous-titres, ajouter des sous-titres traduits, ou effacer les sous-titres existants avant d'afficher les sous-titres traduits. La valeur par défaut est `none`. | | `subtitle_style_id` | Chaîne | Facultatif ; s'applique avec `add` ou `replace` | Applique un style de sous-titres copié depuis un projet dans l'application web Vozo. S'il est omis, le style de sous-titres par défaut intégré est utilisé. ID du style de sous-titres Pn | | `subtitle_position_y` | Nombre de `0` à `1` | Facultatif ; s'applique avec `add` ou `replace` | Définit la position verticale des sous-titres, du haut (`0`) vers le bas (`1`). Par exemple, `0,75` place les sous-titres à 75 % de la hauteur de la vidéo. Voir les règles de positionnement ci-dessous. Lorsque `enable_proofreading` est `true` et que `subtitle_mode` est `replace`, ce champ n'a aucun effet. | Si `subtitle_style_id` est omis, le style par défaut intégré est utilisé. Il affiche une seule ligne centrée avec du texte blanc Noto Sans Medium en taille de police 14, un contour noir externe et une légère ombre noire. La largeur des sous-titres est de 80 % de la vidéo, sans arrière-plan, effet de mot actif ni transition. Si `subtitle_position_y` est omis, sa valeur ne provient pas du style de sous-titres sélectionné. La position est déterminée par `subtitle_mode` : * Pour `add`, la valeur par défaut est `0,9` pour les vidéos en paysage et carrées, et `0,75` pour les vidéos en portrait. * Pour `replace`, les sous-titres sont placés à la position d’origine des sous-titres. Lorsque `enable_proofreading` est `true` et que `subtitle_mode` est `replace`, la position des sous-titres reste dans la zone où les sous-titres originaux ont été effacés une fois le doublage terminé dans le projet. Toute valeur spécifiée dans `subtitle_position_y` est ignorée. ### Projet et sortie | Champ | Valeurs | Exigence | Description | | - | - | - | - | | `project_mode` | `none`, `editable` | Facultatif | Contrôle si un projet modifiable est créé dans l'application web Vozo. La valeur par défaut est `none`. Avec `editable`, un projet est créé et le média final est tout de même exporté selon `export_type` et rendu disponible au téléchargement. | | `enable_proofreading` | Booléen | Facultatif ; forfait Studio ou supérieur requis | Active le flux de relecture. La valeur par défaut est `false`. Lorsqu'il est activé, un projet est toujours créé, `project_mode` est ignoré, et aucun média final n'est exporté, quelle que soit la valeur de `export_type`. S'il est utilisé avec `subtitle_mode: replace`, la position des sous-titres reste dans la zone d'effacement des sous-titres originaux une fois le doublage du projet terminé, et `subtitle_position_y` est ignoré. | | `export_type` | `auto`, `video`, `audio`, `all` | Conditionnel ; requis lorsque `enable_proofreading` est `false` | Sélectionne le format de sortie et n'a pas de valeur par défaut. `auto` correspond au type d'entrée. Pour une entrée audio, `video` et `all` ne sont pas pris en charge. | | `callback_url` | URL | Facultatif | Reçoit un webhook chaque fois que le statut de la tâche change. | ## Sorties (selon `export_type`, `project_mode` et `enable_proofreading`) : * URL de la vidéo et/ou de l’audio traduits * `subtitle_url` traduit (SRT) * `project_url` lorsqu’un projet est créé dans le Tableau de bord web ## Fonctionnement Téléversez votre vidéo ou votre audio, ainsi que toutes les ressources facultatives, afin que nos serveurs puissent les récupérer. Fournissez les entrées requises ainsi que tous les paramètres facultatifs nécessaires à la tâche. Utilisez notre callback webhook ou interrogez l’API avec l’ID de votre tâche jusqu’à la fin du traitement. Récupérez la vidéo/l’audio traduits et le sous-titre traduit (.srt) à partir des URL fournies. ## Limitation d’utilisation * Seuls les utilisateurs pouvant créer des clés API peuvent utiliser cette API. * La limite de concurrence par défaut est de 10 tâches. Cette limite est partagée par tous les membres d’une équipe. Consultez [Limites de concurrence](/docs/fr/api_reference/get_started#concurrency-limits) pour plus de détails. * Le code de langue suit la norme IETF BCP 47, par exemple : en‑US. ## Codes d’erreur API | Code | Description | | - | - | | 5 | Paramètres de requête invalides. | | 7 | Aucune permission pour effectuer la requête. | | 104 | Crédits insuffisants. | | 814 | Votre compte n’est pas membre et n’est pas autorisé à appeler l’API. | | 1000 | Erreur interne du serveur. | | 1301 | Échec du Callback Challenge. | | 1302 | La clé API a été révoquée. | | 1304 | La clé API a atteint le nombre maximal de requêtes simultanées. | | 1503 | Votre compte n’est pas autorisé à appeler l’API. | ## Codes d’erreur de tâche | Code | Description | | - | - | | 10001 | Le fichier téléversé ne contient aucun flux vidéo | | 10002 | La vidéo téléversée ne contient aucun flux audio | | 10003 | Le transcodage a échoué | | 10004 | Échec de la génération de la sortie HLS | | 10005 | Échec du recadrage de la vidéo | | 10010 | Échec de la séparation vocale (parole vs. arrière-plan) | | 10020 | Échec de la reconnaissance automatique de la parole (ASR) | | 10021 | Échec de l’ASR multi-intervenants | | 10022 | Échec de la diarisation des intervenants (chinois) | | 10023 | Échec de la génération des sous-titres complets | | 10030 | Échec de la traduction | | 10031 | Langues mixtes détectées ; l’agrégation a échoué après l’ajustement de la ponctuation | | 10032 | Échec de l’extraction OCR | | 10033 | Langue OCR non prise en charge | | 10034 | Échec de l’alignement des sous-titres (SRT) | | 10040 | Échec du clonage vocal | | 10041 | Aucun contenu vocal reconnu | | 10042 | Aucune parole détectée | | 10043 | Échec du reclonage de la voix | | 10044 | Le texte d’aperçu pour la synthèse vocale (TTS) est vide | | 10045 | Échec de la génération de l’audio d’aperçu | ## Langues prises en charge ### Langues sources Remarque : `auto` est pris en charge pour détecter automatiquement la langue source et mettre à jour la langue source lorsqu’elle est détectée. | Code | Nom | | - | - | | auto | Détection automatique | | en-US | Anglais (États-Unis) | | en-GB | Anglais (Royaume-Uni) | | en-AU | Anglais (Australie) | | en-CA | Anglais (Canada) | | en-GH | Anglais (Ghana) | | en-HK | Anglais (Hong Kong) | | en-IE | Anglais (Irlande) | | en-IN | Anglais (Inde) | | en-KE | Anglais (Kenya) | | en-NG | Anglais (Nigéria) | | en-NZ | Anglais (Nouvelle-Zélande) | | en-PH | Anglais (Philippines) | | en-SG | Anglais (Singapour) | | en-TZ | Anglais (Tanzanie) | | en-ZA | Anglais (Afrique du Sud) | | zh-CN | Chinois (Chine, simplifié) | | zh-HK | Chinois (Hong Kong, traditionnel) | | zh-TW | Chinois (Taïwan, traditionnel) | | es-ES | Espagnol (Espagne) | | es-MX | Espagnol (Mexique) | | es-US | Espagnol (États-Unis) | | es-AR | Espagnol (Argentine) | | es-BO | Espagnol (Bolivie) | | es-CL | Espagnol (Chili) | | es-CO | Espagnol (Colombie) | | es-CR | Espagnol (Costa Rica) | | es-CU | Espagnol (Cuba) | | es-DO | Espagnol (République dominicaine) | | es-EC | Espagnol (Équateur) | | es-GQ | Espagnol (Guinée équatoriale) | | es-GT | Espagnol (Guatemala) | | es-HN | Espagnol (Honduras) | | es-NI | Espagnol (Nicaragua) | | es-PA | Espagnol (Panama) | | es-PE | Espagnol (Pérou) | | es-PR | Espagnol (Porto Rico) | | es-PY | Espagnol (Paraguay) | | es-SV | Espagnol (Salvador) | | es-UY | Espagnol (Uruguay) | | es-VE | Espagnol (Venezuela) | | ar-EG | Arabe (Égypte) | | ar-SA | Arabe (Arabie saoudite) | | ar-AE | Arabe (Émirats arabes unis) | | ar-MA | Arabe (Maroc) | | ar-SY | Arabe (Syrie) | | ru-RU | Russe (Russie) | | pt-PT | Portugais (Portugal) | | pt-BR | Portugais (Brésil) | | fr-BE | Français (Belgique) | | fr-CA | Français (Canada) | | fr-CH | Français (Suisse) | | fr-FR | Français (France) | | de-DE | Allemand (Allemagne) | | de-AT | Allemand (Autriche) | | de-CH | Allemand (Suisse) | | ko-KR | Coréen (Corée du Sud) | | ja-JP | Japonais (Japon) | | hi-IN | Hindi (Inde) | | tr-TR | Turc (Turquie) | | ur-IN | Ourdou (Inde) | | fil-PH | Filipino (Philippines) | | fi-FI | Finnois (Finlande) | | cs-CZ | Tchèque (République tchèque) | | hu-HU | Hongrois (Hongrie) | | da-DK | Danois (Danemark) | | nl-BE | Néerlandais (Belgique) | | pl-PL | Polonais (Pologne) | | ro-RO | Roumain (Roumanie) | | sk-SK | Slovaque (Slovaquie) | | sv-SE | Suédois (Suède) | | hr-HR | Croate (Croatie) | | id-ID | Indonésien (Indonésie) | | it-IT | Italien (Italie) | | it-CH | Italien (Suisse) | | bg-BG | Bulgare (Bulgarie) | | el-GR | Grec (Grèce) | | ms-MY | Malais (Malaisie) | | ta-IN | Tamoul (Inde) | | uk-UA | Ukrainien (Ukraine) | | sq-AL | Albanais (Albanie) | | az-AZ | Azerbaïdjanais (Azerbaïdjan) | | eu-ES | Basque (Espagne) | | bn-IN | Bengali (Inde) | | bs-BA | Bosnien (Bosnie-Herzégovine) | | yue-CN | Cantonais (Chine) | | ca-ES | Catalan (Espagne) | | gl-ES | Galicien (Espagne) | | gu-IN | Gujarati (Inde) | | is-IS | Islandais (Islande) | | kn-IN | Kannada (Inde) | | kk-KZ | Kazakh (Kazakhstan) | | lv-LV | Letton (Lettonie) | | lt-LT | Lituanien (Lituanie) | | mk-MK | Macédonien (Macédoine du Nord) | | ml-IN | Malayalam (Inde) | | mt-MT | Maltais (Malte) | | mr-IN | Marathi (Inde) | | mn-MN | Mongol (Mongolie) | | ne-NP | Népalais (Népal) | | nb-NO | Norvégien bokmål (Norvège) | | pa-IN | Pendjabi (Inde) | | sl-SI | Slovène (Slovénie) | | so-SO | Somali (Somalie) | | sr-RS | Serbe (Serbie) | | sw-KE | Swahili (Kenya) | | sw-TZ | Swahili (Tanzanie) | | uz-UZ | Ouzbek (Ouzbékistan) | | vi-VN | Vietnamien (Vietnam) | | he-IL | Hébreu (Israël) | | fa-IR | Persan (Iran) | | th-TH | Thaï (Thaïlande) | ### Langues cibles | Code | Nom | Variantes régionales | | - | - | - | | en | Anglais | en‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ | | zh | Chinois | zh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI | | wuu | Chinois wu | wuu‑CN | | es | Espagnol | es‑ES, es‑MX, es‑US, es‑AR, es‑BO, es‑CL, es‑CO, es‑CR, es‑CU, es‑DO, es‑EC, es‑SV, es‑GQ, es‑GT, es‑HN, es‑NI, es‑PA, es‑PY, es‑PE, es‑PR, es‑UY, es‑VE | | ar | Arabe | ar‑DZ, ar‑BH, ar‑IQ, ar‑JO, ar‑KW, ar‑LB, ar‑LY, ar‑MA, ar‑OM, ar‑QA, ar‑SY, ar‑TN, ar‑AE, ar‑YE | | ru | Russe | ru‑RU | | pt | Portugais | pt‑PT, pt‑BR | | fr | Français | fr‑FR, fr‑CA, fr‑BE, fr‑CH | | de | Allemand | de‑DE, de‑AT, de‑CH | | ko | Coréen | ko‑KR | | ja | Japonais | ja‑JP | | hi | Hindi | hi‑IN | | tr | Turc | tr‑TR | | fil | Filipino | fil‑PH | | fi | Finnois | fi‑FI | | cs | Tchèque | cs‑CZ | | da | Danois | da‑DK | | nl | Néerlandais | nl‑BE | | pl | Polonais | pl‑PL | | ro | Roumain | ro‑RO | | sk | Slovaque | sk‑SK | | sv | Suédois | sv‑SE | | hr | Croate | hr‑HR | | id | Indonésien | id‑ID | | it | Italien | it‑IT, it‑CH | | bg | Bulgare | bg‑BG | | el | Grec | el‑GR | | ms | Malais | ms‑MY | | ta | Tamoul | ta‑IN, ta‑MY, ta‑SG, ta‑LK | | uk | Ukrainien | uk‑UA | | th | Thaï | th‑TH | | vi | Vietnamien | vi‑VN | | am | Amharique | am‑ET | | bn | Bengali | bn‑IN, bn‑BD | | as | Assamais | as | | bs | Bosnien | bs‑BA | | ca | Catalan | ca‑ES | | et | Estonien | et‑EE | | eu | Basque | eu‑ES | | gl | Galicien | gl‑ES | | gu | Gujarati | gu | | he | Hébreu | he‑IL | | hu | Hongrois | hu‑HU | | iu | Inuktitut | iu‑CANS‑CA, iu‑LATN‑CA | | jv | Javanais | jv‑ID | | mk | Macédonien | mk‑MK | | mr | Marathi | mr | | nb | Norvégien Bokmål | nb‑NO | | ne | Népalais | ne‑NP | | or | Oriya | or | | pa | Pendjabi | pa | | ps | Pachto | ps‑AF | | sl | Slovène | sl‑SI | | sw | Swahili | sw‑KE, sw‑TZ | | te | Télougou | te‑IN | | ur | Ourdou | ur, ur‑IN, ur‑PK | | zu | Zoulou | zu‑ZA | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.