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

> Publica videos completados de la API de Vozo en YouTube

La API de Exportación de YouTube publica una tarea de video completada de Vozo en un canal de YouTube conectado. Puedes publicar videos de Traducción y Doblaje, Traducción Visual o Sincronización Labial. La API devuelve un nuevo **ID de tarea de exportación**; consulta la tarea de exportación hasta que esté en estado `done` o `failed`.

## Antes de comenzar

* Conecta y autoriza tu canal de YouTube en Vozo. Si la conexión ha expirado, vuelve a autorizarla antes de crear una exportación.
* Necesitas acceso a la API de Vozo, tener habilitada la exportación a YouTube para tu cuenta y contar con un Plan Studio o superior.
* La tarea de origen de Vozo debe pertenecer al mismo usuario y estar completada. Su archivo de video debe seguir estando disponible.
* La publicación en YouTube está sujeta tanto a la cuota de exportación de 24 horas de tu cuenta como a una cuota del sistema.
* Usa una clave de API en el encabezado `Authorization: Bearer <api_key>`.

## Flujo de trabajo

<Steps>
  <Step title="Obtener categorías de video">
    Llama a [List categories](/docs/es/api_reference/endpoints/youtube_export/categories) para obtener un `category_id` válido para la región de tu canal conectado. Solo se devuelven las categorías asignables.
  </Step>

  <Step title="Crear una exportación">
    Llama a [Create export task](/docs/es/api_reference/endpoints/youtube_export/create) con la tarea de origen completada, el título, la categoría y la configuración de privacidad. Conserva el `task_id` devuelto: identifica la **exportación de YouTube**, no la tarea original de Vozo.
  </Step>

  <Step title="Consultar la tarea de exportación">
    Llama a [Get export task](/docs/es/api_reference/endpoints/youtube_export/get) con el ID de la tarea de exportación. Cuando `status` sea `done`, usa `studio_url` para abrir el video en YouTube Studio. Si es `failed`, revisa `error_code`.
  </Step>
</Steps>

## Tareas de origen y modos

| `task_type`        | `source_mode` compatible                         | Comportamiento                                                                                                                    |
| ------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `translate_dub`    | `initial_output`, `generate_new`, `use_existing` | Publica el video exportado original, vuelve a renderizar el proyecto editable o reutiliza una exportación existente del proyecto. |
| `visual_translate` | `initial_output`, `generate_new`, `use_existing` | Las mismas opciones para un video de Traducción Visual.                                                                           |
| `lip_sync`         | Omitir `source_mode`                             | Siempre publica la salida inicial de la tarea completada de Sincronización Labial.                                                |

Para Traducción y Doblaje y Traducción Visual, `source_mode` es obligatorio cuando la tarea de origen tiene un proyecto editable. En una tarea de origen no editable, omitirlo selecciona `initial_output`. `generate_new` y `use_existing` requieren el proyecto editable asociado; `use_existing` también requiere un video exportado existente. `initial_output` requiere una salida de video de la tarea de origen.

## Estado de la exportación

| Estado       | Significado                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------- |
| `pending`    | La tarea de exportación fue aceptada, pero aún no ha comenzado.                                     |
| `processing` | La publicación está en curso.                                                                       |
| `done`       | La publicación se completó; `studio_url` está disponible cuando YouTube ha devuelto un ID de video. |
| `failed`     | La publicación falló; `error_code` está presente cuando hay disponible un motivo del fallo.         |

<Note>
  Estos endpoints no crean ni autorizan una conexión de YouTube. Completa esa configuración en Vozo antes de usar la API de exportación.
</Note>

## Errores comunes de la API

| Código | Significado                                                   |
| ------ | ------------------------------------------------------------- |
| `1300` | No se encontró la tarea de origen o de exportación.           |
| `1601` | La cuenta de YouTube no está conectada.                       |
| `1602` | La exportación a YouTube está deshabilitada para esta cuenta. |
| `1603` | La cuota de exportación a YouTube de la cuenta se ha agotado. |
| `1604` | La cuota de YouTube del sistema se ha agotado.                |
| `1605` | La conexión de YouTube requiere una nueva autorización.       |
| `1710` | El Plan actual no cumple con el requisito del Plan Studio.    |

Para otros fallos, inspecciona los campos `code`, `message` y `errors` opcional de la respuesta. Una tarea de publicación también puede llegar a `failed` después de haber sido creada; consulta su `error_code` para ese resultado.