Skip to main content

Entradas y salidas

Entrada:
  • video_url
  • idioma de origen e idioma de destino
  • [opcional] glossary_ids
  • [opcional] user_prompt
  • [opcional] project_mode
Salida:
  • video_url traducida
  • project_url cuando project_mode es editable

Cómo funciona

1

Aloja tu video en una URL accesible públicamente

Sube tu video de entrada para que nuestros servidores puedan recuperarlo. El video no debe durar más de 20 minutos.
2

Envía una solicitud de traducción visual

Incluye los códigos de idioma de origen y de destino, así como IDs de glosario opcionales o instrucciones de prompt para la terminología y el estilo.
3

Espera o consulta el estado

Usa la devolución de llamada de tu webhook o consulta la API periódicamente con el ID de tarea devuelto hasta que el procesamiento se complete.
4

Descarga el video traducido

Cuando el trabajo haya finalizado, recupera el video traducido desde video_url. Si creaste un proyecto editable, abre project_url para revisarlo o editarlo en el Tablero web.

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.
  • 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. Pasa explícitamente un código de idioma de origen admitido.
  • El código de idioma sigue el estilo IETF BCP 47, por ejemplo, en-US, zh-CN, zh-CN-GUANGXI.

Códigos de error de la API

Códigos de error del trabajo

Última modificación el 9 de julio de 2026