Skip to main content
POST
Create a YouTube export task
A tarefa de origem deve estar concluída e pertencer ao usuário da chave de API. Escolha task_type entre translate_dub, visual_translate ou lip_sync. Para um projeto editável de Tradução e Dublagem ou Tradução Visual, escolha explicitamente um source_mode; para Sincronização Labial, omita-o. title deve conter texto que não seja espaço em branco e ter no máximo 100 caracteres Unicode. description pode estar vazio, mas não deve exceder 5.000 caracteres Unicode. privacy_status deve ser private, unlisted ou public. Escolha category_id em Listar categorias para a região do canal conectado. O task_id da resposta é o ID da tarefa de exportação. Ele é diferente do task_id da solicitação, que se refere à tarefa original do Vozo.

Autorizações

Authorization
string
header
obrigatório

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.

Corpo

application/json
task_type
enum<string>
obrigatório

Type of the completed Vozo source task.

Opções disponíveis:
translate_dub,
visual_translate,
lip_sync
task_id
string
obrigatório

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

title
string
obrigatório

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

Maximum string length: 100
category_id
string
obrigatório

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

privacy_status
enum<string>
obrigatório

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

Opções disponíveis:
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.

Opções disponíveis:
initial_output,
generate_new,
use_existing
description
string

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

Maximum string length: 5000

Resposta

Export task created

task_id
string
obrigatório

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

Última modificação em 22 de setembro de 2026