Vozo Help Center

La API de Traducción Visual localiza el Texto en pantalla en videos mientras preserva su diseño, estilo y animaciones. Úsala para automatizar la traducción de texto visual en presentaciones, demostraciones de productos, videos de marketing y otros videos con texto incrustado. La API devuelve un video traducido y, opcionalmente, puede crear un proyecto editable en la aplicación web de Vozo.

Entradas

Campo	Valores	Requisito	Descripción
`video_url`	URL de video de acceso público	Obligatorio	URL del video de entrada. La duración máxima admitida es de 20 minutos.
`source_language`	Código de idioma compatible	Obligatorio	Idioma de origen del Texto en pantalla. La detección automática no es compatible.
`target_language`	Código de idioma compatible, con configuración regional opcional	Obligatorio	Idioma de destino del Texto en pantalla traducido.
`glossary_ids`	Matriz de hasta 3 ID	Opcional	Aplica glosarios creados en la aplicación web de Vozo para mantener una terminología coherente.
`user_prompt`	Cadena	Opcional	Proporciona instrucciones sobre el estilo de Traducción Visual.
`project_mode`	`none`, `editable`	Opcional	Controla si se crea un proyecto editable de Traducción Visual en la aplicación web de Vozo. El valor predeterminado es `none`.
`callback_url`	URL	Opcional	Recibe un webhook cada vez que cambia el estado del trabajo.

Salidas

video_url traducida
project_url cuando project_mode es editable

Cómo funciona

Aloja tu video en una URL de acceso público

Sube el video de entrada para que nuestros servidores puedan obtenerlo. El video no debe superar los 20 minutos.

Envía una solicitud de Traducción Visual

Proporciona las entradas obligatorias y los ajustes opcionales necesarios para el trabajo.

Espera o consulta el estado

Usa el webhook de devolución de llamada o consulta la API con el ID de tarea devuelto hasta que finalice el procesamiento.

Descarga el video traducido

Cuando finalice el trabajo, obtén el video traducido desde la URL proporcionada. Si creaste un proyecto editable, abre la URL del proyecto para revisarlo o editarlo en el Panel.

Limitaciones de uso

Solo los usuarios que pueden crear claves API pueden usar esta API.
Se requiere el Plan Studio; los usuarios que no sean Studio no están autorizados.
El límite de concurrencia predeterminado es de 10 trabajos. Todos los miembros de un equipo comparten este límite. Consulta Límites de concurrencia para obtener más información.
La entrada debe ser un archivo de video. No se admite la exportación de solo audio.
La duración máxima de entrada admitida es de 20 minutos.
La detección automática del idioma de origen no es compatible. Proporciona explícitamente un código de idioma de origen compatible.
El código de idioma sigue el formato IETF BCP 47, por ejemplo, en-US, zh-CN, zh-CN-GUANGXI.

Códigos de error de la API

Código	Descripción
5	Parámetros de solicitud no válidos.
7	No tienes permiso para realizar la solicitud.
104	Créditos insuficientes.
814	Tu cuenta no es miembro y no tiene permiso para llamar a la API.
1000	Error interno del servidor.
1301	Falló el Callback Challenge.
1302	La clave API ha sido revocada.
1304	La clave API ha alcanzado el número máximo de solicitudes simultáneas.
1503	Tu cuenta no está autorizada para llamar a la API.
1305	Solo se permite el Plan Studio.

Códigos de error del trabajo

Código	Descripción
40002	El archivo subido no tiene flujo de video.
40010	Falló la transcodificación.
40050	Falló la traducción.
40020	Falló la extracción de OCR.
40032	No hay callouts válidos en el video.
40040	Falló la coincidencia de OCR con callouts.
40041	No se pudo hacer coincidir ningún callout con OCR.
40060	Falló el refinamiento de callouts.
40061	No se pudo extraer el estilo en el refinamiento.
40080	Falló la generación del video de vista previa.

Idiomas compatibles

Idiomas de origen

La detección automática no es compatible. Proporcione uno de los siguientes códigos de idioma:

Código	Nombre
sq-AL	Albanés
az-AZ	Azerbaiyano
eu-ES	Vasco
bs-BA	Bosnio
ca-ES	Catalán
zh-CN	Chino (simplificado)
zh-TW	Chino (tradicional)
hr-HR	Croata
cs-CZ	Checo
da-DK	Danés
nl-NL	Neerlandés
en-US	Inglés
et-EE	Estonio
fi-FI	Finés
fr-FR	Francés
gl-ES	Gallego
de-DE	Alemán
hi-IN	Hindi
hu-HU	Húngaro
is-IS	Islandés
id-ID	Indonesio
ga-IE	Irlandés
it-IT	Italiano
ja-JP	Japonés
ko-KR	Coreano
lv-LV	Letón
lt-LT	Lituano
ms-MY	Malayo
mt-MT	Maltés
nb-NO	Noruego
fa-IR	Persa
pl-PL	Polaco
pt-PT	Portugués
ro-RO	Rumano
ru-RU	Ruso
sr-RS	Serbio
sk-SK	Eslovaco
sl-SI	Esloveno
es-ES	Español
sw-KE	Suajili
sv-SE	Sueco
fil-PH	Filipino
tr-TR	Turco
uz-UZ	Uzbeko
vi-VN	Vietnamita

Idiomas de destino

Código	Nombre	Variantes regionales
en	Inglés	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	Chino	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	Chino wu	wuu‑CN
es	Español	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	Árabe	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	Ruso	ru‑RU
pt	Portugués	pt‑PT, pt‑BR
fr	Francés	fr‑FR, fr‑CA, fr‑BE, fr‑CH
de	Alemán	de‑DE, de‑AT, de‑CH
ko	Coreano	ko‑KR
ja	Japonés	ja‑JP
hi	Hindi	hi‑IN
tr	Turco	tr‑TR
fil	Filipino	fil‑PH
fi	Finés	fi‑FI
cs	Checo	cs‑CZ
da	Danés	da‑DK
nl	Neerlandés	nl‑BE
pl	Polaco	pl‑PL
ro	Rumano	ro‑RO
sk	Eslovaco	sk‑SK
sv	Sueco	sv‑SE
hr	Croata	hr‑HR
id	Indonesio	id‑ID
it	Italiano	it‑IT, it‑CH
bg	Búlgaro	bg‑BG
el	Griego	el‑GR
ms	Malayo	ms‑MY
ta	Tamil	ta‑IN, ta‑MY, ta‑SG, ta‑LK
uk	Ucraniano	uk‑UA
th	Tailandés	th‑TH
vi	Vietnamita	vi‑VN
am	Amárico	am‑ET
bn	Bengalí	bn‑IN, bn‑BD
as	Asamés	as
bs	Bosnio	bs‑BA
ca	Catalán	ca‑ES
et	Estonio	et‑EE
eu	Vasco	eu‑ES
gl	Gallego	gl‑ES
gu	Guyaratí	gu
he	Hebreo	he‑IL
hu	Húngaro	hu‑HU
iu	Inuktitut	iu‑CANS‑CA, iu‑LATN‑CA
jv	Javanés	jv‑ID
mk	Macedonio	mk‑MK
mr	Maratí	mr
nb	Noruego bokmål	nb‑NO
ne	Nepalí	ne‑NP
or	Oriya	or
pa	Panyabí	pa
ps	Pastún	ps‑AF
sl	Esloveno	sl‑SI
sw	Suajili	sw‑KE, sw‑TZ
te	Telugu	te‑IN
ur	Urdu	ur, ur‑IN, ur‑PK
zu	Zulú	zu‑ZA

Visión general

API de Traducción y doblaje

API de Traducción Visual

API de Lip Sync

API de Lip Sync reutilizable

Resumen

Entradas

Salidas

Cómo funciona

Limitaciones de uso

Códigos de error de la API

Códigos de error del trabajo

Idiomas compatibles

Idiomas de origen

Idiomas de destino

​Entradas

​Salidas

​Cómo funciona

​Limitaciones de uso

​Códigos de error de la API

​Códigos de error del trabajo

​Idiomas compatibles

​Idiomas de origen

​Idiomas de destino

Entradas

Salidas

Cómo funciona

Limitaciones de uso

Códigos de error de la API

Códigos de error del trabajo

Idiomas compatibles

Idiomas de origen

Idiomas de destino