> ## 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 Export API は、完了した Vozo の動画タスクを接続済みの YouTube チャンネルに公開します。翻訳＆吹き替え、ビジュアル翻訳、または リップシンク の動画を公開できます。API は新しい **エクスポートタスク ID** を返します。エクスポートタスクが `done` または `failed` になるまでポーリングしてください。

## 始める前に

* Vozo で YouTube チャンネルを接続して認可してください。接続の有効期限が切れている場合は、エクスポートを作成する前に再認可してください。
* Vozo API へのアクセス権、アカウントで有効化された YouTube エクスポート機能、そして Studio プラン以上が必要です。
* 元の Vozo タスクは同じユーザーに属し、完了している必要があります。その動画ファイルが引き続き利用可能である必要もあります。
* YouTube への公開は、アカウントの 24 時間あたりのエクスポート上限とシステム上限の両方の対象となります。
* `Authorization: Bearer <api_key>` ヘッダーで API キーを使用してください。

## ワークフロー

<Steps>
  <Step title="動画カテゴリを取得">
    接続済みチャンネルの地域で有効な `category_id` を取得するには、[List categories](/docs/ja/api_reference/endpoints/youtube_export/categories) を呼び出します。返されるのは割り当て可能なカテゴリのみです。
  </Step>

  <Step title="エクスポートを作成">
    完了した元タスク、タイトル、カテゴリ、公開設定を指定して [Create export task](/docs/ja/api_reference/endpoints/youtube_export/create) を呼び出します。返された `task_id` は保持してください。これは元の Vozo タスクではなく、**YouTube エクスポート** を識別します。
  </Step>

  <Step title="エクスポートタスクをポーリング">
    エクスポートタスク ID を使用して [Get export task](/docs/ja/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` を照会してください。