> ## 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.

# エクスポートタスクを作成

> Publish a completed Vozo Translate & Dub, Visual Translate, or Lip Sync task to the connected YouTube channel.

ソースタスクは完了しており、APIキーのユーザーが所有している必要があります。`task_type` は `translate_dub`、`visual_translate`、または `lip_sync` から選択してください。編集可能な翻訳＆吹き替え または ビジュアル翻訳 のプロジェクトでは、`source_mode` を明示的に選択してください。リップシンク の場合は指定しないでください。

`title` には空白以外の文字を含める必要があり、100 Unicode文字以内でなければなりません。`description` は空でもかまいませんが、5,000 Unicode文字を超えてはいけません。`privacy_status` は `private`、`unlisted`、または `public` である必要があります。接続されているチャンネルの地域に応じて、[カテゴリ一覧](/docs/ja/api_reference/endpoints/youtube_export/categories) から `category_id` を選択してください。

レスポンスの `task_id` は **エクスポートタスクID** です。これは、元のVozoタスクを指すリクエストの `task_id` とは異なります。


## OpenAPI

````yaml POST /v1/youtube/exports
openapi: 3.1.0
info:
  title: Vozo API
  description: API for Generating, Editing and Localizing Talking Videos.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.vozo.ai
security:
  - bearerAuth: []
paths:
  /v1/youtube/exports:
    post:
      summary: Create a YouTube export task
      description: >-
        Publish a completed Vozo Translate & Dub, Visual Translate, or Lip Sync
        task to the connected YouTube channel.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/YouTubeExportRequest'
      responses:
        '200':
          description: Export task created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/YouTubeExportCreated'
        '400':
          description: >-
            Invalid request, source task, channel connection, entitlement, or
            quota
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/YouTubeApiError'
components:
  schemas:
    YouTubeExportRequest:
      type: object
      required:
        - task_type
        - task_id
        - title
        - category_id
        - privacy_status
      properties:
        task_type:
          type: string
          enum:
            - translate_dub
            - visual_translate
            - lip_sync
          description: Type of the completed Vozo source task.
        task_id:
          type: string
          description: Completed Vozo source task ID, not the YouTube export task ID.
        source_mode:
          type: string
          enum:
            - initial_output
            - generate_new
            - use_existing
          description: >-
            For Translate & Dub or Visual Translate: initial_output publishes
            the original exported video; generate_new renders the current
            editable project before publishing; use_existing publishes a video
            already exported from that project. Required for editable-project
            tasks. When omitted for a non-editable task, initial_output is
            selected automatically. Lip Sync always uses its initial output and
            ignores this field.
        title:
          type: string
          maxLength: 100
          description: >-
            YouTube video title. Whitespace-only titles are rejected; limit is
            100 Unicode characters.
        description:
          type: string
          maxLength: 5000
          description: YouTube video description. Limit is 5,000 Unicode characters.
        category_id:
          type: string
          description: >-
            An assignable category ID returned by GET /v1/youtube/categories for
            the connected channel region.
        privacy_status:
          type: string
          enum:
            - private
            - unlisted
            - public
          description: >-
            YouTube privacy setting. The server trims whitespace and normalizes
            this value to lowercase.
    YouTubeExportCreated:
      type: object
      required:
        - task_id
      properties:
        task_id:
          type: string
          description: >-
            New YouTube export task ID; use it to query GET
            /v1/youtube/exports/{id}.
    YouTubeApiError:
      type: object
      properties:
        code:
          type: integer
          description: Vozo API error code.
        message:
          type: string
        errors:
          type: array
          items:
            type: string
          description: Additional error details, when available.
        server_ts:
          type: integer
        timestamp:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: APIKey
      description: >-
        Bearer authentication header of the form Bearer <api_key>, where
        <api_key> is your API Key. The token in the sample code is referring to
        this api_key as well.

````