Skip to main content
POST
Create a YouTube export task
La tarea de origen debe estar completa y pertenecer al usuario de la clave API. Elige task_type entre translate_dub, visual_translate o lip_sync. Para un proyecto editable de Traducción y Doblaje o Traducción Visual, elige explícitamente un source_mode; para Sincronización Labial, omítelo. title debe contener texto que no sea espacios en blanco y tener como máximo 100 caracteres Unicode. description puede estar vacío, pero no debe superar los 5.000 caracteres Unicode. privacy_status debe ser private, unlisted o public. Elige category_id de Lista de categorías para la región del canal conectado. El task_id de la respuesta es el ID de la tarea de exportación. Es diferente del task_id de la solicitud, que se refiere a la tarea original de Vozo.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <api_key>, where <api_key> is your API Key. The token in the sample code is referring to this api_key as well.

Cuerpo

application/json
task_type
enum<string>
requerido

Type of the completed Vozo source task.

Opciones disponibles:
translate_dub,
visual_translate,
lip_sync
task_id
string
requerido

Completed Vozo source task ID, not the YouTube export task ID.

title
string
requerido

YouTube video title. Whitespace-only titles are rejected; limit is 100 Unicode characters.

Maximum string length: 100
category_id
string
requerido

An assignable category ID returned by GET /v1/youtube/categories for the connected channel region.

privacy_status
enum<string>
requerido

YouTube privacy setting. The server trims whitespace and normalizes this value to lowercase.

Opciones disponibles:
private,
unlisted,
public
source_mode
enum<string>

For Translate & Dub or Visual Translate: initial_output publishes the original exported video; generate_new renders the current editable project before publishing; use_existing publishes a video already exported from that project. Required for editable-project tasks. When omitted for a non-editable task, initial_output is selected automatically. Lip Sync always uses its initial output and ignores this field.

Opciones disponibles:
initial_output,
generate_new,
use_existing
description
string

YouTube video description. Limit is 5,000 Unicode characters.

Maximum string length: 5000

Respuesta

Export task created

task_id
string
requerido

New YouTube export task ID; use it to query GET /v1/youtube/exports/{id}.

Última modificación el 22 de septiembre de 2026