> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 概览

> 将已完成的 Vozo API 视频发布到 YouTube

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

## 开始之前

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

## 工作流程

<Steps>
  <Step title="获取视频分类">
    调用 [列出分类](/docs/zh/api_reference/endpoints/youtube_export/categories) 以获取适用于你已连接频道所在地区的 `category_id`。返回结果仅包含可分配的分类。
  </Step>

  <Step title="创建导出">
    调用 [创建导出任务](/docs/zh/api_reference/endpoints/youtube_export/create)，并提供已完成的源任务、标题、分类和隐私设置。请保留返回的 `task_id`：它标识的是 **YouTube 导出任务**，而不是原始的 Vozo 任务。
  </Step>

  <Step title="轮询导出任务">
    使用导出任务 ID 调用 [获取导出任务](/docs/zh/api_reference/endpoints/youtube_export/get)。当 `status` 为 `done` 时，可使用 `studio_url` 在 YouTube Studio 中打开该视频。如果状态为 `failed`，请检查 `error_code`。
  </Step>
</Steps>

## 源任务与模式

| `task_type`        | 支持的 `source_mode`                                | 行为                            |
| ------------------ | ------------------------------------------------ | ----------------------------- |
| `translate_dub`    | `initial_output`, `generate_new`, `use_existing` | 发布原始导出视频、重新渲染可编辑项目，或复用现有项目导出。 |
| `visual_translate` | `initial_output`, `generate_new`, `use_existing` | 画面翻译视频也可使用相同的选项。              |
| `lip_sync`         | 省略 `source_mode`                                 | 始终发布已完成口型同步任务的初始输出。           |

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

## 导出状态

| 状态           | 含义                                         |
| ------------ | ------------------------------------------ |
| `pending`    | 导出任务已被接受，但尚未开始。                            |
| `processing` | 正在发布中。                                     |
| `done`       | 发布已完成；当 YouTube 返回视频 ID 后，`studio_url` 可用。 |
| `failed`     | 发布失败；当存在失败原因时，会提供 `error_code`。            |

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

## 常见 API 错误

| 代码     | 含义                   |
| ------ | -------------------- |
| `1300` | 未找到源任务或导出任务。         |
| `1601` | YouTube 账号未连接。       |
| `1602` | 此账号未启用 YouTube 导出功能。 |
| `1603` | 账号的 YouTube 导出配额已用尽。 |
| `1604` | 系统 YouTube 配额已用尽。    |
| `1605` | YouTube 连接需要重新授权。    |
| `1710` | 当前方案不满足 Studio 方案要求。 |

对于其他失败情况，请检查响应中的 `code`、`message` 以及可选的 `errors` 字段。发布任务在创建后也可能进入 `failed` 状态；对于这种情况，请查询其 `error_code`。