Temps de réponse
Ces chiffres sont mesurés sur le trafic réel de l'API, pas sur un banc d'essai. Chaque ligne indique la médiane (la moitié des appels sont plus rapides), la quantité à laquelle elle correspond, et le nombre d'appels sur lequel elle est calculée — pour que vous puissiez juger de sa solidité vous-même.
| Opération | Médiane | Pour | Appels mesurés |
|---|---|---|---|
| Traduction | 1,8 s | ≈ 200 caractères | 498 |
| Synthèse vocale | 5,5 s | ≈ 200 caractères | 447 |
Fenêtre de mesure : 60 jours, appels réussis uniquement. Ces valeurs sont indicatives et ne constituent pas un engagement contractuel.
Ce qu'il faut prévoir pour les appels les plus lents (p95)
La médiane ci-dessus décrit le cas courant. Pour régler un timeout côté client, la médiane ne suffit pas : il faut savoir sous quel délai se terminent la quasi-totalité des appels, pas seulement la moitié. Sur un échantillon récent d'une semaine, voici le temps sous lequel se terminent 95 % des appels réussis (p95) pour chaque opération.
| Opération | p95 (95 % des appels) |
|---|---|
| Traduction | ≈ 95 s |
| Synthèse vocale | ≈ 34 s |
Fenêtre de mesure du p95 : 7 jours (échantillon plus récent et plus resserré que la médiane ci-dessus ; les deux tableaux ne portent pas exactement sur la même période).
En cas de forte affluence, un appel peut occasionnellement prendre nettement plus de temps que la médiane, sans dépasser la fenêtre p95 ci-dessus dans l'immense majorité des cas. Recommandations :
- Timeout client : au moins 120 secondes pour la traduction, 60 secondes pour la synthèse vocale.
- Retry avec back-off sur
503: respecte l'en-têteRetry-After, voir l'exemple de code dans Erreurs. - Pour un gros volume, préfère plusieurs appels courts (ou plusieurs jobs de sous-titrage/doublage) à un seul appel géant.
Les traitements longs ne sont pas synchrones
Le sous-titrage et le doublage ne rendent pas leur résultat dans la réponse : ils créent un job, et vous récupérez le résultat ensuite. Leur durée dépend de la longueur de la vidéo, pas d'un temps de réponse d'API. Utilisez un webhook plutôt qu'une boucle d'interrogation.
L'API répond en requête/réponse : chaque appel renvoie son résultat complet, il n'existe pas encore de mode flux (SSE/WebSocket) pour recevoir l'audio ou le texte au fur et à mesure. Adapté aux messages et annonces pré-générés ; pour un usage conversationnel temps réel (chatbot vocal, IVR), c'est une limite actuelle à anticiper dans votre conception.