done or failed.
Before you start
- Connect and authorize your YouTube channel in Vozo. If the connection has expired, reauthorize it before creating an export.
- You need access to the Vozo API, YouTube export enabled for your account, and a Studio plan or higher.
- The source Vozo task must belong to the same user and be complete. Its video file must still be available.
- YouTube publishing is subject to both your account’s 24-hour export quota and a system quota.
- Use an API key in the
Authorization: Bearer <api_key>header.
Workflow
1
Get video categories
Call List categories to obtain a
category_id valid for your connected channel’s region. Only assignable categories are returned.2
Create an export
Call Create export task with the completed source task, title, category, and privacy setting. Keep the returned
task_id: it identifies the YouTube export, not the original Vozo task.3
Poll the export task
Call Get export task with the export task ID. Once
status is done, use studio_url to open the video in YouTube Studio. If it is failed, check error_code.Source tasks and modes
For Translate & Dub and Visual Translate,
source_mode is required when the source task has an editable project. For a non-editable source task, omitting it selects initial_output. generate_new and use_existing require the associated editable project; use_existing also requires an existing exported video. initial_output requires a video output from the source task.
Export status
These endpoints do not create or authorize a YouTube connection. Complete that setup in Vozo before using the export API.
Common API errors
For other failures, inspect the response’s
code, message, and optional errors fields. A publishing task may also reach failed after it was created; query its error_code for that outcome.