Limites de débit

Plafonds de requêtes par clé, par minute et par jour.

Valeurs par défaut

Les nouvelles clés ont par défaut 60 requêtes par minute et 10 000 par jour. L'augmentation du plafond d'une clé spécifique n'est pas encore en libre-service ; contactez notre équipe à [email protected] si vous avez besoin d'un plafond différent pour l'une des vôtres.

En-têtes de réponse

Chaque requête, succès ou échec, renvoie l'état actuel de la limite de débit dans les en-têtes. Surveillez-les dans votre client et ralentissez lorsque vous approchez de zéro.

Succès avec marge

text

HTTP/1.1 200 OK
X-RateLimit-Remaining-RPM: 47
X-RateLimit-Remaining-Daily: 9842
X-Request-ID: 5b7e9c2a-4f31-...

Quand vous atteignez la limite

Lorsque vous dépassez le plafond par minute ou par jour, le serveur renvoie 429 Too Many Requests avec Retry-After (en secondes). Respectez-le et implémentez un backoff exponentiel pour les 429 répétés.

Astuce

Besoin de plus de débit ? Répartissez le trafic sur plusieurs clés (chacune a son propre compteur) ou contactez notre équipe à [email protected] pour augmenter votre plafond. Les limites par clé ne sont pas encore en libre-service dans le tableau de bord. Dans tous les cas, n'effectuez jamais de boucle intensive sur un 429 : utilisez un backoff avec jitter sur les nouvelles tentatives.

Réponse 429

text

HTTP/1.1 429 Too Many Requests
X-RateLimit-Remaining-RPM: 0
X-RateLimit-Remaining-Daily: 9842
Retry-After: 60

{
  "error": "Rate limit exceeded",
  "code": "rate_limited",
  "request_id": "0cf409f7-382a-4c24-be9f-ae1192c38619",
  "detail": "Rate limit exceeded"
}

Streaming et longues requêtes

Une requête TTS en streaming ou un job de transcription longue durée compte comme une seule requête contre votre RPM. Les octets audio / caractères consommés sont suivis séparément dans votre utilisation de crédits et n'affectent pas les en-têtes de limite de débit.