Source: https://aiprimetech.io/it/docs/api-reference/rate-limits/

[Home](/it/) / [Documentazione](/it/docs/) / Limiti di frequenza 

# Limiti di frequenza 

Come funziona la limitazione delle richieste, cosa significa un 429 in questo contesto e come creare un client che non lo provochi. 

 Copia pagina [ Visualizza in Markdown](/it/docs/api-reference/rate-limits.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/rate-limits.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Chiedi in Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/rate-limits.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

I limiti garantiscono un uso equo della capacità condivisa dei fornitori a monte. Si applicano per account, non per chiave, quindi aggiungere chiavi non aumenta il limite massimo. 

## Cosa viene limitato 

 | Aspetto | Comportamento

 | Richieste simultanee | Richieste in corso per account. La causa più comune di un 429.

 | Richieste al minuto | Frequenza continuativa delle chiamate.

 | Token al minuto | Volume complessivo di token in ingresso e in uscita. 

I piani illimitati applicano limiti di uso equo anziché un saldo di crediti: eliminano il costo per token, non il limite massimo di richieste simultanee. 

## Gestire correttamente 429 
- Aumenta esponenzialmente l'attesa tra i tentativi con una variazione casuale: un secondo, due secondi, quattro secondi, otto secondi, ciascuno più o meno una frazione casuale.
- Limita le richieste simultanee lato client con un semaforo, invece di inviarle tutte e riprovare quelle rifiutate.
- Metti in coda le elaborazioni in batch invece di parallelizzarle al massimo; il throughput è limitato dai token al minuto, non dal numero di socket che apri.
- Tratta 529 in modo diverso da 429 — dipende dalla capacità del fornitore a monte, non da te, e di solito si risolve in pochi secondi. 

```
Copyimport asyncio

sem = asyncio.Semaphore(8)      class=class="s">"c"># ceiling on concurrency, tune to your plan

async def ask(client, body):
    async with sem:
        return await client.post(class="s">"/v1/messages", json=body)
```

Gli strumenti agentici come Claude Code avviano molte operazioni in parallelo per progettazione. Se riscontri errori 429 durante un uso intensivo degli agenti, riduci il parallelismo dello strumento prima di passare a un piano superiore. 

## Ridurre il carico invece di riprovare 
- Instrada le attività meno onerose verso claude-haiku-4-5 — i modelli più piccoli terminano prima e occupano uno slot per meno tempo.
- Attiva [la cache dei prompt](/it/docs/guides/prompt-caching/): i prefissi in cache riducono i token in ingresso e quindi il carico sul limite di token al minuto.
- Riduci la cronologia della conversazione; vedi [Gestione del contesto](/it/docs/guides/context-management/).
- Raggruppa le attività offline in batch da eseguire nelle fasce di minor traffico. 

[ErroriRiferimento dei codici di stato](/it/docs/api-reference/errors/)[Controllo dei costiSpendi meno per attività](/it/docs/guides/cost-control/)[PianiOpzioni a tariffa fissa](/it/docs/billing/plans/) 

[PrecedenteErrori](/it/docs/api-reference/errors/)[AvantiUso degli strumenti e chiamata di funzioni](/it/docs/api-reference/tool-use/)