> ## 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 密钥用户所有。从 `translate_dub`、`visual_translate` 或 `lip_sync` 中选择 `task_type`。对于可编辑的翻译与配音或画面翻译项目，需要显式选择 `source_mode`；对于口型同步，则省略该字段。

`title` 必须包含非空白文本，且最多为 100 个 Unicode 字符。`description` 可以为空，但不得超过 5,000 个 Unicode 字符。`privacy_status` 必须是 `private`、`unlisted` 或 `public`。根据已连接频道所属地区，从 [分类列表](/docs/zh/api_reference/endpoints/youtube_export/categories) 中选择 `category_id`。

响应中的 `task_id` 是 **导出任务 ID**。它不同于请求中的 `task_id`，后者指的是原始 Vozo 任务。


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

````