Entrées
Médias et langues
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.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é. |
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.  |
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é.  |
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 est0,9pour les vidéos en paysage et carrées, et0,75pour les vidéos en portrait. - Pour
replace, les sous-titres sont placés à la position d’origine des sous-titres.
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
Sorties
(selonexport_type, project_mode et enable_proofreading) :
- URL de la vidéo et/ou de l’audio traduits
subtitle_urltraduit (SRT)project_urllorsqu’un projet est créé dans le Tableau de bord web
Fonctionnement
1
Hébergez vos ressources à une URL accessible publiquement
Téléversez votre vidéo ou votre audio, ainsi que toutes les ressources facultatives, afin que nos serveurs puissent les récupérer.
2
Envoyez une requête API
Fournissez les entrées requises ainsi que tous les paramètres facultatifs nécessaires à la tâche.
3
Attendez ou interrogez l’état
Utilisez notre callback webhook ou interrogez l’API avec l’ID de votre tâche jusqu’à la fin du traitement.
4
Téléchargez les sorties
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 pour plus de détails.
- Le code de langue suit la norme IETF BCP 47, par exemple : en‑US.
Codes d’erreur API
Codes d’erreur de tâche
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.