Skip to main content
POST
Create a YouTube export task
The source task must be complete and owned by the API-key user. Choose task_type from translate_dub, visual_translate, or lip_sync. For an editable Translate & Dub or Visual Translate project, explicitly choose a source_mode; for Lip Sync, omit it. title must contain non-whitespace text and be at most 100 Unicode characters. description may be empty but must not exceed 5,000 Unicode characters. privacy_status must be private, unlisted, or public. Choose category_id from List categories for the connected channel’s region. The response task_id is the export task ID. It is different from the request’s task_id, which refers to the original Vozo task.

Authorizations

Authorization
string
header
required

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.

Body

application/json
task_type
enum<string>
required

Type of the completed Vozo source task.

Available options:
translate_dub,
visual_translate,
lip_sync
task_id
string
required

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

title
string
required

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

Maximum string length: 100
category_id
string
required

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

privacy_status
enum<string>
required

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

Available options:
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.

Available options:
initial_output,
generate_new,
use_existing
description
string

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

Maximum string length: 5000

Response

Export task created

task_id
string
required

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

Last modified on September 22, 2026