Passer au contenu principal

​
Entrées et sorties

Entrée :
  • video_url
  • langue source et langue cible
  • [optionnel] glossary_ids
  • [optionnel] user_prompt
  • [optionnel] project_mode
Sortie :
  • video_url traduite
  • project_url lorsque project_mode est editable

​
Fonctionnement

1

Hébergez votre vidéo à une URL accessible publiquement

Téléversez votre vidéo d’entrée afin que nos serveurs puissent la récupérer. La vidéo ne doit pas dépasser 20 minutes.
2

Envoyez une demande de Traduction visuelle

Incluez les codes de langue source et cible, ainsi que des identifiants de glossaire optionnels ou des instructions de prompt pour la terminologie et le style.
3

Attendez ou vérifiez le statut

Utilisez le callback de votre webhook ou interrogez l’API avec l’identifiant de tâche renvoyé jusqu’à la fin du traitement.
4

Téléchargez la vidéo traduite

Lorsque le traitement est terminé, récupérez la vidéo traduite depuis video_url. Si vous avez créé un projet modifiable, ouvrez project_url pour le réviser ou le modifier dans le Tableau de bord web.

​
Limitation d’utilisation

  • Seuls les utilisateurs autorisés à créer des clés API peuvent utiliser cette API.
  • Le forfait Studio est requis ; les utilisateurs non-Studio ne sont pas autorisés.
  • L’entrée doit être un fichier vidéo. L’export audio uniquement n’est pas pris en charge.
  • La durée maximale d’entrée prise en charge est de 20 minutes.
  • La détection automatique de la langue source n’est pas prise en charge. Fournissez explicitement un code de langue source pris en charge.
  • Le code de langue suit le style IETF BCP 47, par exemple en-US, zh-CN, zh-CN-GUANGXI.

​
Codes d’erreur de l’API

CodeDescription
5Paramètres de requête invalides.
7Aucune permission pour effectuer la requête.
104Crédits insuffisants.
814Votre compte n’est pas membre et n’est pas autorisé à appeler l’API.
1000Erreur interne du serveur.
1301L’épreuve de callback a échoué.
1302La clé API a été révoquée.
1304La clé API a atteint le nombre maximal de requêtes simultanées.
1503Votre compte n’est pas autorisé à appeler l’API.
1305Seul le forfait Studio est autorisé.

​
Codes d’erreur de tâche

CodeDescription
40002Le fichier téléversé ne contient aucun flux vidéo.
40010Le transcodage a échoué.
40050La traduction a échoué.
40020L’extraction OCR a échoué.
40032Aucun callout valide dans la vidéo.
40040L’association de l’OCR aux callouts a échoué.
40041Impossible d’associer un callout à l’OCR.
40060L’amélioration des callouts a échoué.
40061L’extraction du style lors de l’amélioration a échoué.
40080La génération de la vidéo d’aperçu a échoué.
Dernière modification le 9 juillet 2026