Plateforme

Limites et règles des clés

Limitez chaque clé API à son usage prévu : ses dépenses, son débit, les modèles accessibles, les adresses d’origine et sa durée de validité. Définissez ces limites à la création de la clé, ou à tout moment dans Clés API → Modifier.

Les règles

RègleEn cas de dépassementErreur
Budget mensuel (USD)Requêtes refusées jusqu’au mois suivant (UTC)402 key_budget_exceeded
Budget quotidien (USD)Requêtes refusées jusqu’à minuit UTC402 key_daily_budget_exceeded
Limite de débit (requêtes par minute)Requêtes temporairement refusées, avec retry-after429 rate_limit_exceeded
ExpirationLa clé cesse de fonctionner401 expired_api_key
Modèles autorisésLes autres modèles sont refusés403 model_not_allowed
Adresses IP autoriséesLes requêtes provenant d’autres adresses sont refusées403 ip_not_allowed

Les requêtes refusées ne sont jamais facturées. Les budgets incluent les montants réservés par les requêtes en cours de la clé (voir Facturation) : une requête susceptible de dépasser un budget est donc refusée avant de démarrer, et une réponse qui atteint un budget en cours de génération s’arrête avec l’erreur correspondante. Les modifications s’appliquent partout sous 15 secondes. Le solde de votre espace de travail s’applique à toutes les clés : s’il ne suffit pas à couvrir une requête, celle-ci reçoit 402 insufficient_quota.

Modèles autorisés

Choisissez les modèles de votre choix, pour le texte, l’image ou la vidéo. Une clé limitée, par exemple, à gpt-6-sol et gemini-3.7-flash ne peut appeler aucun autre modèle, et le routage intelligent n’utilise que les modèles de remplacement de cette liste. Autoriser Zurelay Auto permet à la clé d’utiliser le modèle choisi par Auto.

Adresses IP autorisées

Adresses individuelles et plages CIDR, en IPv4 et IPv6, jusqu’à 100 par clé. L’adresse vérifiée est celle d’où provient votre requête sur Internet (derrière un proxy ou un NAT, c’est celle du proxy).

Exemples
203.0.113.7 one address
198.51.100.0/24 a range of 256 addresses
2001:db8::/32 an IPv6 range
Les plateformes serverless et certains clouds envoient les requêtes depuis des adresses variables. Utilisez une plage d’adresses de sortie publiée par votre fournisseur, ou ne limitez pas les IP de ces clés et appuyez-vous sur les autres règles.

Les budgets en pratique

  • Attribuez à chaque application ou environnement sa propre clé et son propre budget, pour qu’une boucle incontrôlée ne puisse pas épuiser le solde.
  • Un budget quotidien limite les dégâts d’un bug le jour même ; un budget mensuel plafonne la facture.
  • La page Clés API affiche les dépenses de chaque clé pour la journée et le mois en cours, à côté de ses budgets.

Une question ou un élément manquant ? Contactez notre équipe d’assistance et nous vous répondrons par e-mail, généralement en moins d’une minute.