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

# Vue d’ensemble

> Publier des vidéos Vozo API terminées sur YouTube

L’API d’export YouTube publie une tâche vidéo Vozo terminée sur une chaîne YouTube connectée. Vous pouvez publier des vidéos issues de Traduction et doublage, Traduction visuelle ou Synchronisation labiale. L’API renvoie un nouvel **identifiant de tâche d’export** ; interrogez régulièrement la tâche d’export jusqu’à ce qu’elle soit `done` ou `failed`.

## Avant de commencer

* Connectez et autorisez votre chaîne YouTube dans Vozo. Si la connexion a expiré, réautorisez-la avant de créer un export.
* Vous devez avoir accès à l’API Vozo, disposer de l’export YouTube activé pour votre compte, et avoir un forfait Studio ou supérieur.
* La tâche Vozo source doit appartenir au même utilisateur et être terminée. Son fichier vidéo doit toujours être disponible.
* La publication sur YouTube est soumise à la fois au quota d’export sur 24 heures de votre compte et à un quota système.
* Utilisez une clé API dans l’en-tête `Authorization: Bearer <api_key>`.

## Flux de travail

<Steps>
  <Step title="Obtenir les catégories de vidéo">
    Appelez [Lister les catégories](/docs/fr/api_reference/endpoints/youtube_export/categories) pour obtenir un `category_id` valide pour la région de votre chaîne connectée. Seules les catégories attribuables sont renvoyées.
  </Step>

  <Step title="Créer un export">
    Appelez [Créer une tâche d’export](/docs/fr/api_reference/endpoints/youtube_export/create) avec la tâche source terminée, le titre, la catégorie et le paramètre de confidentialité. Conservez le `task_id` renvoyé : il identifie l’**export YouTube**, et non la tâche Vozo d’origine.
  </Step>

  <Step title="Interroger la tâche d’export">
    Appelez [Obtenir la tâche d’export](/docs/fr/api_reference/endpoints/youtube_export/get) avec l’identifiant de la tâche d’export. Une fois que `status` est `done`, utilisez `studio_url` pour ouvrir la vidéo dans YouTube Studio. S’il est `failed`, vérifiez `error_code`.
  </Step>
</Steps>

## Tâches source et modes

| `task_type`        | `source_mode` pris en charge                     | Comportement                                                                                                            |
| ------------------ | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| `translate_dub`    | `initial_output`, `generate_new`, `use_existing` | Publie la vidéo exportée d’origine, restitue à nouveau le projet modifiable, ou réutilise un export de projet existant. |
| `visual_translate` | `initial_output`, `generate_new`, `use_existing` | Les mêmes choix pour une vidéo de Traduction visuelle.                                                                  |
| `lip_sync`         | Omettre `source_mode`                            | Publie toujours la sortie initiale de la tâche Synchronisation labiale terminée.                                        |

Pour Traduction et doublage et Traduction visuelle, `source_mode` est requis lorsque la tâche source dispose d’un projet modifiable. Pour une tâche source non modifiable, son omission sélectionne `initial_output`. `generate_new` et `use_existing` nécessitent le projet modifiable associé ; `use_existing` nécessite également une vidéo exportée existante. `initial_output` nécessite une sortie vidéo provenant de la tâche source.

## Statut de l’export

| Statut       | Signification                                                                                         |
| ------------ | ----------------------------------------------------------------------------------------------------- |
| `pending`    | Tâche d’export acceptée mais pas encore démarrée.                                                     |
| `processing` | La publication est en cours.                                                                          |
| `done`       | Publication terminée ; `studio_url` est disponible lorsque YouTube a renvoyé un identifiant de vidéo. |
| `failed`     | La publication a échoué ; `error_code` est présent lorsqu’une raison d’échec est disponible.          |

<Note>
  Ces endpoints ne créent ni n’autorisent une connexion YouTube. Terminez cette configuration dans Vozo avant d’utiliser l’API d’export.
</Note>

## Erreurs API courantes

| Code   | Signification                                                   |
| ------ | --------------------------------------------------------------- |
| `1300` | La tâche source ou la tâche d’export est introuvable.           |
| `1601` | Le compte YouTube n’est pas connecté.                           |
| `1602` | L’export YouTube est désactivé pour ce compte.                  |
| `1603` | Le quota d’export YouTube du compte est épuisé.                 |
| `1604` | Le quota YouTube du système est épuisé.                         |
| `1605` | La connexion YouTube nécessite une nouvelle autorisation.       |
| `1710` | Le forfait actuel ne répond pas à l’exigence du forfait Studio. |

Pour les autres échecs, examinez les champs `code`, `message` et `errors` facultatif(s) de la réponse. Une tâche de publication peut également passer à l’état `failed` après sa création ; interrogez son `error_code` pour ce résultat.