Skip to main content
YouTube 导出 API 会将已完成的 Vozo 视频任务发布到已连接的 YouTube 频道。你可以发布来自翻译与配音、画面翻译或口型同步的视频。该 API 会返回一个新的 导出任务 ID;请轮询该导出任务,直到其状态变为 donefailed

开始之前

  • 请先在 Vozo 中连接并授权你的 YouTube 频道。如果连接已过期,请在创建导出前重新授权。
  • 你需要具备 Vozo API 的访问权限、你的账号已启用 YouTube 导出功能,并且使用 Studio 或更高方案。
  • 源 Vozo 任务必须属于同一用户,且已完成。其视频文件也必须仍然可用。
  • YouTube 发布同时受你账号的 24 小时导出配额和系统配额限制。
  • 请在 Authorization: Bearer <api_key> 请求头中使用 API 密钥。

工作流程

1

获取视频分类

调用 列出分类 以获取适用于你已连接频道所在地区的 category_id。返回结果仅包含可分配的分类。
2

创建导出

调用 创建导出任务,并提供已完成的源任务、标题、分类和隐私设置。请保留返回的 task_id:它标识的是 YouTube 导出任务,而不是原始的 Vozo 任务。
3

轮询导出任务

使用导出任务 ID 调用 获取导出任务。当 statusdone 时,可使用 studio_url 在 YouTube Studio 中打开该视频。如果状态为 failed,请检查 error_code

源任务与模式

对于翻译与配音和画面翻译,当源任务包含可编辑项目时,必须提供 source_mode。对于不可编辑的源任务,省略该字段则会选择 initial_outputgenerate_newuse_existing 都要求存在关联的可编辑项目;use_existing 还要求已有导出视频。initial_output 则要求源任务已生成视频输出。

导出状态

这些端点不会创建或授权 YouTube 连接。在使用导出 API 之前,请先在 Vozo 中完成该设置。

常见 API 错误

对于其他失败情况,请检查响应中的 codemessage 以及可选的 errors 字段。发布任务在创建后也可能进入 failed 状态;对于这种情况,请查询其 error_code
最后修改于 2026年9月22日