API dei limiti di velocità

L'API dei limiti di velocità fornisce accesso programmatico ai 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 inserire valori hardcoded che diventano obsoleti quando Anthropic li modifica.
• Alimentare gli avvisi interni: Confronta i dati di utilizzo provenienti dalla Usage and Cost API 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 la Messages API 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, mentre altri gruppi coprono risorse come la Message Batches API, la Files API, la Token Counting API, le agent skill 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 modello e alias che viene conteggiato nei limiti di quel gruppo. Usa questo elenco per cercare in quale gruppo rientra 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, o ) e è il limite configurato. Consulta 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 restituire 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 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 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 appaiono nell'elenco models?

Ogni ID modello e alias che viene conteggiato nel 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 alla Messages API 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
• Usage and Cost API