Entrées et sorties
Entrée :- video_url
- langue source et langue cible
- [optionnel] glossary_ids
- [optionnel] user_prompt
- [optionnel] project_mode
- video_url traduite
- project_url lorsque
project_modeesteditable
Fonctionnement
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.
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.
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.
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
| Code | Description |
|---|---|
| 5 | Paramètres de requête invalides. |
| 7 | Aucune permission pour effectuer la requête. |
| 104 | Crédits insuffisants. |
| 814 | Votre compte n’est pas membre et n’est pas autorisé à appeler l’API. |
| 1000 | Erreur interne du serveur. |
| 1301 | L’épreuve de callback a échoué. |
| 1302 | La clé API a été révoquée. |
| 1304 | La clé API a atteint le nombre maximal de requêtes simultanées. |
| 1503 | Votre compte n’est pas autorisé à appeler l’API. |
| 1305 | Seul le forfait Studio est autorisé. |
Codes d’erreur de tâche
| Code | Description |
|---|---|
| 40002 | Le fichier téléversé ne contient aucun flux vidéo. |
| 40010 | Le transcodage a échoué. |
| 40050 | La traduction a échoué. |
| 40020 | L’extraction OCR a échoué. |
| 40032 | Aucun callout valide dans la vidéo. |
| 40040 | L’association de l’OCR aux callouts a échoué. |
| 40041 | Impossible d’associer un callout à l’OCR. |
| 40060 | L’amélioration des callouts a échoué. |
| 40061 | L’extraction du style lors de l’amélioration a échoué. |
| 40080 | La génération de la vidéo d’aperçu a échoué. |