done 或 failed。
开始之前
- 请先在 Vozo 中连接并授权你的 YouTube 频道。如果连接已过期,请在创建导出前重新授权。
- 你需要具备 Vozo API 的访问权限、你的账号已启用 YouTube 导出功能,并且使用 Studio 或更高方案。
- 源 Vozo 任务必须属于同一用户,且已完成。其视频文件也必须仍然可用。
- YouTube 发布同时受你账号的 24 小时导出配额和系统配额限制。
- 请在
Authorization: Bearer <api_key>请求头中使用 API 密钥。
工作流程
1
获取视频分类
调用 列出分类 以获取适用于你已连接频道所在地区的
category_id。返回结果仅包含可分配的分类。2
创建导出
调用 创建导出任务,并提供已完成的源任务、标题、分类和隐私设置。请保留返回的
task_id:它标识的是 YouTube 导出任务,而不是原始的 Vozo 任务。3
轮询导出任务
使用导出任务 ID 调用 获取导出任务。当
status 为 done 时,可使用 studio_url 在 YouTube Studio 中打开该视频。如果状态为 failed,请检查 error_code。源任务与模式
对于翻译与配音和画面翻译,当源任务包含可编辑项目时,必须提供
source_mode。对于不可编辑的源任务,省略该字段则会选择 initial_output。generate_new 和 use_existing 都要求存在关联的可编辑项目;use_existing 还要求已有导出视频。initial_output 则要求源任务已生成视频输出。
导出状态
这些端点不会创建或授权 YouTube 连接。在使用导出 API 之前,请先在 Vozo 中完成该设置。
常见 API 错误
对于其他失败情况,请检查响应中的
code、message 以及可选的 errors 字段。发布任务在创建后也可能进入 failed 状态;对于这种情况,请查询其 error_code。