Kooma API
English Clés API S'inscrire

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érationMédianePourAppels mesurés
Traduction1,8 s≈ 200 caractères498
Synthèse vocale5,5 s≈ 200 caractères447

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érationp95 (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).

Régler ton timeout et ton retry

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ête Retry-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.

Pas de streaming pour l'instant

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.

↑↓ naviguer↵ ouvriresc fermer