Skip to main content
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

1

Obtenir les catégories de vidéo

Appelez Lister les catégories pour obtenir un category_id valide pour la région de votre chaîne connectée. Seules les catégories attribuables sont renvoyées.
2

Créer un export

Appelez Créer une tâche d’export 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.
3

Interroger la tâche d’export

Appelez Obtenir la tâche d’export 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.

Tâches source et modes

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

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

Erreurs API courantes

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.
Dernière modification le 22 septembre 2026