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

# Créer une tâche d’exportation

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

La tâche source doit être terminée et appartenir à l’utilisateur de la clé API. Choisissez `task_type` parmi `translate_dub`, `visual_translate` ou `lip_sync`. Pour un projet Traduction et doublage ou Traduction visuelle modifiable, choisissez explicitement un `source_mode` ; pour Synchronisation labiale, omettez-le.

`title` doit contenir du texte autre que des espaces et comporter au maximum 100 caractères Unicode. `description` peut être vide mais ne doit pas dépasser 5 000 caractères Unicode. `privacy_status` doit être `private`, `unlisted` ou `public`. Choisissez `category_id` dans [Liste des catégories](/docs/fr/api_reference/endpoints/youtube_export/categories) pour la région de la chaîne connectée.

Le `task_id` de la réponse est l’**ID de la tâche d’exportation**. Il est différent du `task_id` de la requête, qui fait référence à la tâche Vozo d’origine.


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

````