Vai al contenuto principale
Le intestazioni dei limiti sono incluse nelle rotte limitate. Le chiavi master e UNLIMITED_API_KEYS aggirano questo limite e possono non ricevere X-RateLimit-*. I nomi delle intestazioni HTTP non distinguono maiuscole e minuscole. Una nuova chiave valida usa prima il limite IP; dopo il riscaldamento della cache delle credenziali usa quello personale (ad esempio, 40 → 120 per le statistiche). Retry-After viene inviato in caso di limite. Sui metodi compatibili con OpenAI /v1/* gli stessi valori usano i nomi di OpenAI: x-ratelimit-limit-requests, x-ratelimit-remaining-requests e x-ratelimit-reset-requests (tempo al reset, ad esempio 1s). Vedi la panoramica dell’API IA.

​
Risposta 429

Quando il limite viene superato, l’API risponde con HTTP 429. Il corpo contiene solo codice e messaggio; il tempo di attesa è negli header:
Se continui a inviare richieste dopo un 429, la chiave o l’IP vengono bloccati per un po’: ricevi il codice 5039 e Retry-After indica quanto attendere.

​
Come gestirlo

  • Controlla X-RateLimit-Remaining e rallenta quando si avvicina a zero.
  • Dopo un 429 attendi Retry-After secondi e riprova solo la richiesta rifiutata.
  • Non ripetere alla cieca le richieste di scrittura dopo un errore di rete: verifica prima se sono state applicate.
  • Metti in cache le risposte che cambiano di rado.
Davanti all’API c’è Cloudflare, con limiti propri. Se un IP invia troppe richieste, Cloudflare risponde con l’errore 1015 (HTTP 429): è una sua pagina, non JSON dell’API, e senza header X-RateLimit-*. Rallenta e attendi qualche minuto: riprovare durante il blocco lo prolunga.