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

> API de Traduction visuelle

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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