API Rate Limits

L'API Rate Limits fornisce accesso programmatico ai "rate limit" (limiti di velocità) configurati per la tua organizzazione e i suoi workspace. Queste sono le stesse informazioni mostrate nella pagina Limits nella Claude Console.

Usa questa API per:

• Mantenere sincronizzati gateway e proxy: Leggi i tuoi limiti attuali all'avvio e in modo pianificato invece di codificare valori fissi che si disallineano quando Anthropic li modifica.
• Alimentare sistemi di allerta interni: Confronta i dati di utilizzo dell'API Usage and Cost con i limiti configurati.
• Verificare la configurazione dei workspace: Verifica che gli override dei workspace corrispondano a quanto previsto dalla tua automazione di provisioning.



Avvio rapido

Elenca i limiti di velocità configurati per la tua organizzazione:

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Limiti di velocità dell'organizzazione

L'endpoint /v1/organizations/rate_limits restituisce i limiti di velocità applicati a livello di organizzazione per l'API Messages e le sue risorse di supporto. I limiti per altri prodotti, come Claude Managed Agents, non sono inclusi.



Concetti chiave

• Gruppi di limiti di velocità: Ogni voce nella risposta rappresenta un gruppo di limiti di velocità. I limiti di velocità dei modelli sono raggruppati in modo che diverse versioni di modello condividano un unico insieme di limiti, e altri gruppi coprono risorse come l'API Message Batches, l'API Files, l'API Token Counting, le agent skills e lo strumento di ricerca web.
• group_type: Identifica quale categoria di limiti copre la voce. Consulta Filtrare per tipo di gruppo per l'elenco dei valori.
• Elenco models: Per le voci model_group, il campo models elenca ogni ID di modello e alias che viene conteggiato nei limiti di quel gruppo. Usa questo elenco per individuare a quale gruppo appartiene una qualsiasi stringa di modello. Per gli altri tipi di gruppo, models è null.
• Elenco limits: Ogni gruppo contiene un elenco di coppie {type, value}. Il campo type identifica il limitatore (come requests_per_minute, input_tokens_per_minute o output_tokens_per_minute) e value è il limite configurato. Consulta Limiti di velocità per sapere come ogni limitatore viene misurato e applicato.

Per i dettagli completi dei parametri e gli schemi di risposta, consulta il riferimento API Organization Rate Limits.



Elencare tutti i limiti di velocità dell'organizzazione

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}



Cercare i limiti per un modello specifico

Passa un qualsiasi ID di modello o alias come parametro di query model per restituire solo la voce che lo contiene:

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Se la stringa del modello non corrisponde a nessun gruppo, l'endpoint restituisce un errore 404. Il parametro model è supportato solo sull'endpoint dell'organizzazione; l'endpoint del workspace non lo accetta.



Limiti di velocità del workspace

L'endpoint /v1/organizations/workspaces/{workspace_id}/rate_limits restituisce gli override dei limiti di velocità configurati per un singolo workspace.

La risposta include solo gli override, quindi tutto ciò che manca viene ereditato dall'organizzazione:

• Un gruppo assente da data non ha alcun override a livello di workspace. Il workspace eredita i limiti a livello di organizzazione per quel gruppo (non è illimitato).
• All'interno di un gruppo presente, un tipo di limitatore assente da limits[] non ha alcun override a livello di workspace per quel limitatore. Il workspace eredita il valore dell'organizzazione per esso.
• Per ogni limitatore presente, org_limit è il valore a livello di organizzazione per lo stesso limitatore, oppure null se l'organizzazione non ha un limite configurato per quel tipo di limitatore.

Per i dettagli completi dei parametri e gli schemi di risposta, consulta il riferimento API Workspace Rate Limits.

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}



Filtrare per tipo di gruppo

Entrambi gli endpoint accettano un parametro di query opzionale group_type che limita la risposta a una singola categoria:

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

I valori validi sono model_group, batch, token_count, files, skills e web_search.



Paginazione

Entrambi gli endpoint accettano un parametro di query page e restituiscono un campo next_page. Le risposte attualmente sono sempre una singola pagina, quindi next_page è null. Esegui un ciclo su next_page in modo che il tuo client effettui correttamente la paginazione senza modifiche quando la risposta cresce.



Domande frequenti



Quali stringhe di modello compaiono nell'elenco models?

Ogni ID di modello e alias che viene conteggiato nel gruppo, inclusi gli ID datati (come claude-sonnet-4-5-20250929) e gli alias non datati (come claude-sonnet-4-5). Cerca qualsiasi stringa di modello che passi all'API Messages e la troverai esattamente in una voce model_group.



Cosa significa se un gruppo manca dalla risposta del workspace?

Il workspace non ha alcun override per quel gruppo ed eredita il limite a livello di organizzazione. Interroga l'endpoint dell'organizzazione per vedere i valori ereditati.



Posso aggiornare i limiti di velocità con questa API?

No. Per impostare i limiti di velocità del workspace, apri il workspace nella Claude Console e usa la scheda Limits.



Vedi anche

• Limiti di velocità
• Admin API
• Riferimento Admin API
• Workspace
• API Usage and Cost