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
1
Obtener categorías de video
Llama a List categories para obtener un
category_id válido para la región de tu canal conectado. Solo se devuelven las categorías asignables.2
Crear una exportación
Llama a Create export task 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.3
Consultar la tarea de exportación
Llama a Get export task 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.Tareas de origen y modos
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
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.
Errores comunes de la API
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.