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

# Crear tarea de exportación

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

La tarea de origen debe estar completa y pertenecer al usuario de la clave API. Elige `task_type` entre `translate_dub`, `visual_translate` o `lip_sync`. Para un proyecto editable de Traducción y Doblaje o Traducción Visual, elige explícitamente un `source_mode`; para Sincronización Labial, omítelo.

`title` debe contener texto que no sea espacios en blanco y tener como máximo 100 caracteres Unicode. `description` puede estar vacío, pero no debe superar los 5.000 caracteres Unicode. `privacy_status` debe ser `private`, `unlisted` o `public`. Elige `category_id` de [Lista de categorías](/docs/es/api_reference/endpoints/youtube_export/categories) para la región del canal conectado.

El `task_id` de la respuesta es el **ID de la tarea de exportación**. Es diferente del `task_id` de la solicitud, que se refiere a la tarea original de 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.

````