Entradas
Medios e idiomas
Fuentes de texto de subtítulos
Usa estos campos si tienes texto de subtítulos original o traducido para proporcionar. De lo contrario, puedes ignorar esta sección.Traducción y doblaje
Usa estos campos para personalizar los modelos, ajustes o requisitos de traducción y doblaje. De lo contrario, puedes ignorar esta sección.| Campo | Valores | Requisito | Descripción |
|---|---|---|---|
speaker_number | { min, max } | Opcional | Especifica el rango esperado de cantidad de hablantes. min debe ser al menos 1 y max no puede superar 35. Omítelo para la detección automática. |
voice_model | auto, real, native | Opcional | Selecciona el modelo de clonación de voz utilizado para el doblaje. El valor predeterminado es auto: auto selecciona automáticamente el mejor modelo para tu contenido; real usa VoiceREAL para preservar la emoción y el acento de la voz original; native usa VoiceNATIVE para ofrecer un acento más natural en el idioma de destino. |
selected_voice_id | String | Opcional | Usa una voz específica de la Biblioteca de Voces en la aplicación web de Vozo para el doblaje. Cuando se proporciona este campo, anula voice_model: la API omite la clonación automática de voz y utiliza la voz seleccionada para generar el audio doblado. |
align_video | Boolean | Opcional; solo video | Cuando se establece en true, ajusta automáticamente la velocidad del video para que el audio traducido y el video permanezcan sincronizados en todo momento. El valor predeterminado es false. Establécelo en false si el audio traducido se usará como una pista de audio adicional en YouTube. |
glossary_ids | Matriz de hasta 3 ID | Opcional | Aplica los glosarios creados en la aplicación web de Vozo para mantener la terminología coherente.  |
user_prompt | String | Opcional | Proporciona instrucciones de traducción o doblaje, como preferencias de tono, estilo o terminología. |
Salida de subtítulos
Usa estos campos si quieres añadir subtítulos traducidos al video o borrar y reemplazar los subtítulos existentes. De lo contrario, puedes ignorar esta sección.| Campo | Valores | Requisito | Descripción |
|---|---|---|---|
subtitle_mode | none, add, replace | Opcional | Controla el renderizado de subtítulos: no renderizar subtítulos, agregar subtítulos traducidos o borrar los subtítulos existentes antes de renderizar los subtítulos traducidos. El valor predeterminado es none. |
subtitle_style_id | Cadena | Opcional; se aplica con add o replace | Aplica un estilo de subtítulos copiado de un proyecto en la aplicación web de Vozo. Si se omite, se usa el estilo de subtítulos predeterminado integrado.  |
subtitle_position_y | Número de 0 a 1 | Opcional; se aplica con add o replace | Establece la posición vertical de los subtítulos, desde la parte superior (0) hasta la parte inferior (1). Por ejemplo, 0,75 coloca los subtítulos al 75% de la altura del video. Consulta las reglas de posicionamiento a continuación. Cuando enable_proofreading es true y subtitle_mode es replace, este campo no tiene efecto. |
Si se omite
subtitle_style_id, se usa el estilo predeterminado integrado. Muestra una sola línea centrada usando texto blanco Noto Sans Medium con tamaño de fuente 14, un contorno negro exterior y una sutil sombra negra. El ancho de los subtítulos es el 80% del video, sin fondo, efecto de palabra activa ni transición.Si se omite subtitle_position_y, su valor no proviene del estilo de subtítulos seleccionado. La posición está determinada por subtitle_mode:- Para
add, el valor predeterminado es0,9para videos horizontales y cuadrados, y0,75para videos verticales. - Para
replace, los subtítulos se colocan en la posición original de los subtítulos.
enable_proofreading es true y subtitle_mode es replace, la posición de los subtítulos permanece en la región donde se eliminaron los subtítulos originales después de que el doblaje se complete en el proyecto. Se ignora cualquier valor especificado en subtitle_position_y.Proyecto y salida
Salidas
(segúnexport_type, project_mode y enable_proofreading):
- URL del video y/o audio traducido
subtitle_urltraducida (SRT)project_urlcuando se crea un proyecto en el Panel web
Cómo funciona
1
Aloja tus recursos en una URL accesible públicamente
Sube tu video o audio, junto con cualquier recurso opcional, para que nuestros servidores puedan recuperarlos.
2
Envía una solicitud a la API
Proporciona las entradas obligatorias y cualquier configuración opcional necesaria para el trabajo.
3
Espera o consulta el estado
Usa nuestro callback de webhook o consulta la API con tu ID de tarea hasta que el procesamiento se complete.
4
Descargar salidas
Recupera el video/audio traducido y el subtítulo traducido (.srt) desde las URL proporcionadas.
Limitación 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 permitidos.
- El límite de concurrencia predeterminado es de 10 trabajos. El límite es compartido por todos los miembros de un equipo. Consulta Límites de concurrencia para más detalles.
- El código de idioma sigue el estándar IETF BCP 47, por ejemplo, en‑US.