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

# Exportaufgabe erstellen

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

Die Quellaufgabe muss abgeschlossen sein und dem API-Key-Benutzer gehören. Wählen Sie `task_type` aus `translate_dub`, `visual_translate` oder `lip_sync`. Wählen Sie für ein bearbeitbares Projekt vom Typ Übersetzen & Synchronisieren oder Visuelle Übersetzung ausdrücklich einen `source_mode`; bei Lippensynchronisation lassen Sie ihn weg.

`title` muss Text enthalten, der nicht nur aus Leerraum besteht, und darf höchstens 100 Unicode-Zeichen lang sein. `description` darf leer sein, darf aber 5.000 Unicode-Zeichen nicht überschreiten. `privacy_status` muss `private`, `unlisted` oder `public` sein. Wählen Sie `category_id` aus [Kategorien auflisten](/docs/de/api_reference/endpoints/youtube_export/categories) für die Region des verbundenen Kanals.

Die `task_id` der Antwort ist die **Exportaufgaben-ID**. Sie unterscheidet sich von der `task_id` der Anfrage, die sich auf die ursprüngliche Vozo-Aufgabe bezieht.


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

````