Rate Limits API

Die Rate Limits API bietet programmatischen Zugriff auf die Ratenlimits, die für deine Organisation und ihre Workspaces konfiguriert sind. Dies sind dieselben Informationen, die auf der Seite Limits in der Claude Console angezeigt werden.

Verwende diese API, um:

• Gateways und Proxys synchron zu halten: Lies deine aktuellen Limits beim Start und in regelmäßigen Abständen aus, anstatt Werte fest zu codieren, die veralten, wenn Anthropic sie anpasst.
• Internes Alerting zu ermöglichen: Vergleiche Nutzungsdaten aus der Usage and Cost API mit deinen konfigurierten Limits.
• Workspace-Konfiguration zu prüfen: Verifiziere, dass Workspace-Overrides dem entsprechen, was deine Provisionierungsautomatisierung erwartet.

Schnellstart

Liste die für deine Organisation konfigurierten Ratenlimits auf:

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

Organisations-Ratenlimits

Der Endpunkt /v1/organizations/rate_limits gibt die Ratenlimits zurück, die auf Organisationsebene für die Messages API und ihre unterstützenden Ressourcen gelten. Limits für andere Produkte, wie etwa Claude Managed Agents, sind nicht enthalten.

Zentrale Konzepte

• Ratenlimit-Gruppen: Jeder Eintrag in der Antwort repräsentiert eine Ratenlimit-Gruppe. Modell-Ratenlimits sind so gruppiert, dass mehrere Modellversionen einen gemeinsamen Satz von Limits teilen, und andere Gruppen decken Ressourcen wie die Message Batches API, die Files API, die Token Counting API, Agent Skills und das Web-Search-Tool ab.
• group_type: Gibt an, welche Kategorie von Limits der Eintrag abdeckt. Siehe Filtern nach Gruppentyp für die Liste der Werte.
• models-Liste: Bei model_group-Einträgen listet das Feld models jede Modell-ID und jeden Alias auf, die auf die Limits dieser Gruppe angerechnet werden. Verwende diese Liste, um nachzuschlagen, unter welche Gruppe ein beliebiger Modell-String fällt. Bei anderen Gruppentypen ist models gleich null.
• limits-Liste: Jede Gruppe enthält eine Liste von {type, value}-Paaren. Das Feld type identifiziert den Limiter (wie requests_per_minute, input_tokens_per_minute oder output_tokens_per_minute) und value ist das konfigurierte Limit. Siehe Ratenlimits, um zu erfahren, wie jeder Limiter gemessen und durchgesetzt wird.

Vollständige Parameterdetails und Antwortschemata findest du in der Organization Rate Limits API-Referenz.

Alle Organisations-Ratenlimits auflisten

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
}

Die Limits für ein bestimmtes Modell nachschlagen

Übergib eine beliebige Modell-ID oder einen Alias als Query-Parameter model, um nur den Eintrag zurückzugeben, der diese enthält:

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"

Wenn der Modell-String keiner Gruppe entspricht, gibt der Endpunkt einen 404-Fehler zurück. Der Parameter model wird nur am Organisations-Endpunkt unterstützt; der Workspace-Endpunkt akzeptiert ihn nicht.

Workspace-Ratenlimits

Der Endpunkt /v1/organizations/workspaces/{workspace_id}/rate_limits gibt die Ratenlimit-Overrides zurück, die für einen einzelnen Workspace konfiguriert sind.

Die Antwort enthält nur Overrides, sodass alles, was darin fehlt, von der Organisation geerbt wird:

• Eine Gruppe, die in data fehlt, hat überhaupt keinen Workspace-Override. Der Workspace erbt die Limits auf Organisationsebene für diese Gruppe (sie ist nicht unbegrenzt).
• Innerhalb einer vorhandenen Gruppe hat ein Limiter-Typ, der in limits[] fehlt, keinen Workspace-Override für diesen Limiter. Der Workspace erbt dafür den Organisationswert.
• Für jeden vorhandenen Limiter ist org_limit der Wert auf Organisationsebene für denselben Limiter oder null, wenn die Organisation kein konfiguriertes Limit für diesen Limiter-Typ hat.

Vollständige Parameterdetails und Antwortschemata findest du in der Workspace Rate Limits API-Referenz.

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
}

Filtern nach Gruppentyp

Beide Endpunkte akzeptieren einen optionalen Query-Parameter group_type, der die Antwort auf eine einzelne Kategorie beschränkt:

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"

Gültige Werte sind model_group, batch, token_count, files, skills und web_search.

Paginierung

Beide Endpunkte akzeptieren einen Query-Parameter page und geben ein Feld next_page zurück. Antworten bestehen derzeit immer aus einer einzelnen Seite, daher ist next_page gleich null. Iteriere über next_page, damit dein Client ohne Änderungen korrekt paginiert, wenn die Antwort wächst.

Häufig gestellte Fragen

Welche Modell-Strings erscheinen in der models-Liste?

Jede Modell-ID und jeder Alias, die auf die Gruppe angerechnet werden, einschließlich datierter IDs (wie claude-sonnet-4-5-20250929) und undatierter Aliase (wie claude-sonnet-4-5). Schlage einen beliebigen Modell-String nach, den du an die Messages API übergibst, und du findest ihn in genau einem model_group-Eintrag.

Was bedeutet es, wenn eine Gruppe in der Workspace-Antwort fehlt?

Der Workspace hat keinen Override für diese Gruppe und erbt das Limit auf Organisationsebene. Frage den Organisations-Endpunkt ab, um die geerbten Werte zu sehen.

Kann ich Ratenlimits mit dieser API aktualisieren?

Nein. Um Workspace-Ratenlimits festzulegen, öffne den Workspace in der Claude Console und verwende den Tab Limits.

Siehe auch

• Ratenlimits
• Admin API
• Admin API-Referenz
• Workspaces
• Usage and Cost API