Skip to main content
POST
Create a YouTube export task
源任务必须已完成,且归 API 密钥用户所有。从 translate_dubvisual_translatelip_sync 中选择 task_type。对于可编辑的翻译与配音或画面翻译项目,需要显式选择 source_mode;对于口型同步,则省略该字段。 title 必须包含非空白文本,且最多为 100 个 Unicode 字符。description 可以为空,但不得超过 5,000 个 Unicode 字符。privacy_status 必须是 privateunlistedpublic。根据已连接频道所属地区,从 分类列表 中选择 category_id 响应中的 task_id导出任务 ID。它不同于请求中的 task_id,后者指的是原始 Vozo 任务。

授权

Authorization
string
header
必填

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.

请求体

application/json
task_type
enum<string>
必填

Type of the completed Vozo source task.

可用选项:
translate_dub,
visual_translate,
lip_sync
task_id
string
必填

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

title
string
必填

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

Maximum string length: 100
category_id
string
必填

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

privacy_status
enum<string>
必填

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

可用选项:
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.

可用选项:
initial_output,
generate_new,
use_existing
description
string

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

Maximum string length: 5000

响应

Export task created

task_id
string
必填

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

最后修改于 2026年9月22日