> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen

> API de Traducción visual

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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ó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.     |