API dei limiti di velocità

L'API dei limiti di velocità fornisce accesso programmatico ai "rate limits" (limiti di velocità) configurati per la tua organizzazione e i suoi workspace. Si tratta delle stesse informazioni mostrate nella pagina Limits della Claude Console.

Usa questa API per:

• Mantenere sincronizzati gateway e proxy: Leggi i tuoi limiti attuali all'avvio e a intervalli regolari invece di codificare valori fissi che diventano obsoleti quando Anthropic li modifica.
• Alimentare gli avvisi interni: Confronta i dati di utilizzo provenienti dall'API di utilizzo e costi con i limiti configurati.
• Verificare la configurazione dei workspace: Controlla 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 relative 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, mentre altri gruppi coprono risorse come l'API Message Batches, l'API Files, l'API Token Counting, le agent skill e lo strumento di ricerca web.
• group_type: Identifica la categoria di limiti a cui si riferisce 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 modello e alias che viene conteggiato rispetto ai limiti di quel gruppo. Usa questo elenco per individuare a quale gruppo appartiene una determinata 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 viene misurato e applicato ciascun limitatore.

Per i dettagli completi sui parametri e gli schemi di risposta, consulta il riferimento API dei limiti di velocità dell'organizzazione.



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-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 qualsiasi ID modello o alias come parametro di query model per ottenere solo la voce che lo contiene:

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

Se la stringa del modello non corrisponde ad alcun 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 sui parametri e gli schemi di risposta, consulta il riferimento API dei limiti di velocità del workspace.

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-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. Attualmente le risposte sono sempre costituite da una singola pagina, quindi next_page è null. Itera su next_page in modo che il tuo client gestisca correttamente la paginazione senza modifiche quando la risposta crescerà.



Domande frequenti



Quali stringhe di modello compaiono nell'elenco models?

Ogni ID modello e alias che viene conteggiato rispetto al gruppo, inclusi gli ID con data (come claude-sonnet-4-5-20250929) e gli alias senza data (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 è assente 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 di utilizzo e costi