Vozo Help Center

L’API Traduction visuelle localise le Texte à l’écran dans les vidéos tout en préservant sa mise en page, son style et ses animations. Utilisez-la pour automatiser la traduction de texte visuel pour les présentations, les démonstrations de produits, les vidéos marketing et d’autres vidéos contenant du texte intégré. L’API renvoie une vidéo traduite et peut, en option, créer un projet modifiable dans l’application web Vozo.

Entrées

Champ	Valeurs	Condition	Description
`video_url`	URL de vidéo accessible publiquement	Obligatoire	URL de la vidéo d’entrée. La durée maximale prise en charge est de 20 minutes.
`source_language`	Code de langue pris en charge	Obligatoire	Langue source du Texte à l’écran. La détection automatique n’est pas prise en charge.
`target_language`	Code de langue pris en charge, avec paramètres régionaux facultatifs	Obligatoire	Langue cible du Texte à l’écran traduit.
`glossary_ids`	Tableau de 3 ID maximum	Facultatif	Applique les glossaires créés dans l’application web Vozo afin d’assurer la cohérence terminologique.
`user_prompt`	Chaîne	Facultatif	Fournit des instructions sur le style de Traduction visuelle.
`project_mode`	`none`, `editable`	Facultatif	Détermine si un projet de Traduction visuelle modifiable est créé dans l’application web Vozo. La valeur par défaut est `none`.
`callback_url`	URL	Facultatif	Reçoit un webhook chaque fois que l’état de la tâche change.

Sorties

video_url traduite
project_url lorsque project_mode est défini sur editable

Fonctionnement

Hébergez votre vidéo à une URL accessible publiquement

Importez la vidéo d’entrée afin que nos serveurs puissent la récupérer. Sa durée ne doit pas dépasser 20 minutes.

Envoyez une demande de Traduction visuelle

Fournissez les entrées obligatoires et les paramètres facultatifs nécessaires à la tâche.

Attendez ou consultez l’état

Utilisez le webhook de rappel ou interrogez l’API avec l’ID de tâche renvoyé jusqu’à la fin du traitement.

Téléchargez la vidéo traduite

Une fois la tâche terminée, récupérez la vidéo traduite à l’URL fournie. Si vous avez créé un projet modifiable, ouvrez son URL pour le consulter ou le modifier dans le Tableau de bord.

Limitation d’utilisation

Seuls les utilisateurs autorisés à créer des clés API peuvent utiliser cette API.
Le forfait Studio est requis ; les utilisateurs non-Studio ne sont pas autorisés.
La limite de simultanéité par défaut est de 10 tâches. Cette limite est partagée par tous les membres d’une équipe. Consultez les Limites de simultanéité pour en savoir plus.
L’entrée doit être un fichier vidéo. L’export audio uniquement n’est pas pris en charge.
La durée maximale d’entrée prise en charge est de 20 minutes.
La détection automatique de la langue source n’est pas prise en charge. Fournissez explicitement un code de langue source pris en charge.
Le code de langue suit le format IETF BCP 47, par exemple en-US, zh-CN, zh-CN-GUANGXI.

Codes d’erreur de l’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	L’épreuve de callback a échoué.
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.
1305	Seul le forfait Studio est autorisé.

Codes d’erreur de tâche

Code	Description
40002	Le fichier téléversé ne contient aucun flux vidéo.
40010	Le transcodage a échoué.
40050	La traduction a échoué.
40020	L’extraction OCR a échoué.
40032	Aucun callout valide dans la vidéo.
40040	L’association de l’OCR aux callouts a échoué.
40041	Impossible d’associer un callout à l’OCR.
40060	L’amélioration des callouts a échoué.
40061	L’extraction du style lors de l’amélioration a échoué.
40080	La génération de la vidéo d’aperçu a échoué.

Langues prises en charge

Langues source

La détection automatique n’est pas prise en charge. Transmettez l’un des codes de langue suivants :

Code	Nom
sq-AL	Albanais
az-AZ	Azerbaïdjanais
eu-ES	Basque
bs-BA	Bosniaque
ca-ES	Catalan
zh-CN	Chinois (simplifié)
zh-TW	Chinois (traditionnel)
hr-HR	Croate
cs-CZ	Tchèque
da-DK	Danois
nl-NL	Néerlandais
en-US	Anglais
et-EE	Estonien
fi-FI	Finnois
fr-FR	Français
gl-ES	Galicien
de-DE	Allemand
hi-IN	Hindi
hu-HU	Hongrois
is-IS	Islandais
id-ID	Indonésien
ga-IE	Irlandais
it-IT	Italien
ja-JP	Japonais
ko-KR	Coréen
lv-LV	Letton
lt-LT	Lituanien
ms-MY	Malais
mt-MT	Maltais
nb-NO	Norvégien
fa-IR	Persan
pl-PL	Polonais
pt-PT	Portugais
ro-RO	Roumain
ru-RU	Russe
sr-RS	Serbe
sk-SK	Slovaque
sl-SI	Slovène
es-ES	Espagnol
sw-KE	Swahili
sv-SE	Suédois
fil-PH	Filipino
tr-TR	Turc
uz-UZ	Ouzbek
vi-VN	Vietnamien

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	Bosniaque	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

Présentation générale

API de Traduction et doublage

API de Traduction Visuelle

API de Lip Sync

API Lip Sync réutilisable

Vue d’ensemble

Entrées

Sorties

Fonctionnement

Limitation d’utilisation

Codes d’erreur de l’API

Codes d’erreur de tâche

Langues prises en charge

Langues source

Langues cibles

​Entrées

​Sorties

​Fonctionnement

​Limitation d’utilisation

​Codes d’erreur de l’API

​Codes d’erreur de tâche

​Langues prises en charge

​Langues source

​Langues cibles

Entrées

Sorties

Fonctionnement

Limitation d’utilisation

Codes d’erreur de l’API

Codes d’erreur de tâche

Langues prises en charge

Langues source

Langues cibles