Claude Platform Docs
API-ReferenzDie API verwenden

API-Übersicht

Verstehe die verfügbaren Endpunkte, Authentifizierungs-Header, Client-SDKs, Paginierung, Ratenlimits und Cloud-Plattform-Zugriffsoptionen der Claude API.

Die Claude API ist eine RESTful-API unter https://api.anthropic.com, die programmatischen Zugriff auf Claude-Modelle und Claude Managed Agents bietet.

Voraussetzungen

Um die Claude API zu nutzen, benötigst du:

Für eine Schritt-für-Schritt-Einrichtungsanleitung siehe Erste Schritte.

Verfügbare APIs

Die Claude API umfasst die folgenden APIs:

  • Messages APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Sende Nachrichten an Claude für konversationelle Interaktionen (POST /v1/messages)
  • Message Batches APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Verarbeite große Mengen von Messages-Anfragen asynchron mit einer Kostenreduzierung von 50 Prozent (POST /v1/messages/batches)
  • Token Counting APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Zähle Token in einer Nachricht vor dem Senden, um Kosten und Ratenlimits zu verwalten (POST /v1/messages/count_tokens)
  • Models APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Liste verfügbare Claude-Modelle und deren Details auf (GET /v1/models)
  • Files APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Lade Dateien hoch und verwalte sie zur Verwendung über mehrere API-Aufrufe hinweg (POST /v1/files, GET /v1/files)
  • Skills APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.: Erstelle und verwalte benutzerdefinierte Agent-Skills (POST /v1/skills, GET /v1/skills)

Die folgenden APIs befinden sich in der Beta-Phase:

  • Agents API: Definiere wiederverwendbare, versionierte Agent-Konfigurationen für Claude Managed Agents (POST /v1/agents, GET /v1/agents)
  • Sessions API: Führe zustandsbehaftete Agent-Sessions in verwalteten Cloud-Sandboxes aus (POST /v1/sessions, GET /v1/sessions/{id}/events/stream)
  • Environments API: Konfiguriere Sandbox-Vorlagen für Agent-Sessions (POST /v1/environments, GET /v1/environments)

Für die vollständige API-Referenz mit allen Endpunkten, Parametern und Antwortschemata erkunde die in der Navigation aufgeführten API-Referenzseiten. Um auf Beta-Funktionen zuzugreifen, siehe Beta-Header.

Authentifizierung

Für Details zu jeder Authentifizierungsmethode und wann sie zu verwenden ist, siehe Authentifizierung. Anfragen an die Claude API enthalten diese Header:

HeaderWertErforderlich
AuthorizationBearer <token>, wobei <token> dein API-Key oder ein kurzlebiges Zugriffstoken ist, das du über POST /v1/oauth/token mittels Workload Identity Federation erhältstJa, sofern x-api-key nicht gesetzt ist
x-api-keyDein API-Key aus der Console. Veralteter Fallback für Authorization, wird weiterhin unterstütztNein
anthropic-workspace-idID des Workspace, in dem die Anfrage ausgeführt wird (zum Beispiel wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ). Siehe Einen Workspace auswählen.Erforderlich bei einem API-Key, der nicht auf einen Workspace beschränkt ist. Optional für andere API-Keys. Ein für einen einzelnen Workspace erstellter Key wird in diesem Workspace ausgeführt, wenn du den Header weglässt. Wird nicht mit Workload Identity Federation-Tokens verwendet, die beim Token-Austausch einen Workspace auswählen.
anthropic-versionAPI-Version (zum Beispiel 2026-10-21)Ja
content-typeapplication/jsonJa

Wenn du die Client-SDKs verwendest, sendet das SDK die Authentifizierungs-, Versions- und Content-Type-Header automatisch; anthropic-workspace-id übergibst du selbst, wenn dein Key es benötigt. Für Details zur API-Versionierung siehe API-Versionen.

Beim Zugriff auf Claude über eine Cloud-Plattform ist die Authentifizierung in das IAM-System des Cloud-Anbieters integriert. Siehe die plattformspezifische Dokumentation für unterstützte Anmeldeinformationstypen, erforderliche Header und Authentifizierungsoptionen.

API-Keys erhalten

Die API wird über die Web-Console bereitgestellt. In der Console kannst du den Playground (platform.claude.com/playground) verwenden, um die API im Browser auszuprobieren, und anschließend auf der Seite API-Schlüssel (platform.claude.com/settings/keys) API-Keys generieren. Wie das geht, erfährst du unter Hol dir deinen Claude-API-Key. Den Typ jedes Keys (siehe Key-Typen) und seine Ablaufzeit wählst du beim Erstellen aus. Verwende Workspaces in der Console, um Umgebungen zu trennen und Ausgaben nach Anwendungsfall zu steuern.

Client-SDKs

Anthropic stellt offizielle SDKs bereit, die die API-Integration vereinfachen, indem sie Authentifizierung, Anfrageformatierung, Fehlerbehandlung und mehr übernehmen.

Vorteile:

  • Automatische Header-Verwaltung (Authentifizierung, anthropic-version, content-type)
  • Typsichere Anfrage- und Antwortbehandlung
  • Integrierte Wiederholungslogik und Fehlerbehandlung
  • Streaming-Unterstützung
  • Anfrage-Timeouts und Verbindungsverwaltung

Eine Liste der Client-SDKs findest du unter SDKs, CLI und Bibliotheken.

Claude API im Vergleich zu Cloud-Plattformen

Claude ist über die First-Party-Claude-API und über Cloud-Plattformen verfügbar. Wähle basierend auf deiner Infrastruktur, Funktionsverfügbarkeit, Compliance-Anforderungen und Preispräferenzen.

Claude API

  • Direkter Zugriff auf die neuesten Modelle und Funktionen
  • Anthropic-Abrechnung und -Support
  • Am besten geeignet für: Neue Integrationen, vollständiger Funktionszugriff, direkte Beziehung zu Anthropic

Cloud-Plattform-APIs

Greife auf Claude über AWS, Google Cloud oder Microsoft Azure zu:

  • Integriert mit der Abrechnung und dem IAM des Cloud-Anbieters
  • Die Funktionsverfügbarkeit variiert je nach Plattform: Von Anthropic betriebene Plattformen umfassen Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) und Microsoft Foundry; von Partnern betriebene Plattformen umfassen Claude Models on Google Cloud (Google managed) und Amazon Bedrock. Siehe die Seite jeder Plattform für Funktionsverfügbarkeit und Zeitplanung.
  • Am besten geeignet für: Bestehende Cloud-Verpflichtungen, spezifische Compliance-Anforderungen, konsolidierte Cloud-Abrechnung
PlattformAnbieterDokumentation
Claude Models on Google Cloud (Google managed)Google CloudClaude Models on Google Cloud (Google managed)
Amazon BedrockAWSClaude in Amazon Bedrock (bedrock-mantle) und Claude auf Amazon Bedrock (bedrock-runtime)
Claude Platform on AWSAWS (von Anthropic betrieben)Claude Platform on AWS
Claude Models on Google Cloud (Anthropic managed)Google Cloud (von Anthropic betrieben)Claude Models on Google Cloud (Anthropic managed)
Microsoft FoundryMicrosoft Azure (von Anthropic betrieben)Claude in Microsoft Foundry

Anfrage- und Antwortformat

Anfragegrößenlimits

Die First-Party-Claude-API erzwingt diese Größenlimits für Anfragen:

EndpunktMaximale Anfragegröße
Nachrichten, Token-Zählung128 MB
Message Batches API (siehe Batch-Verarbeitung)256 MB
Files API500 MB
Sessions, Agenten, Umgebungen32 MB

Wenn du diese Limits überschreitest, erhältst du einen 413 request_too_large-Fehler.

Antwort-Header

Die Claude API enthält die folgenden Header in ihren Antworten:

HeaderBeschreibung
request-idEin global eindeutiger Bezeichner für die Anfrage, wie req_018EeWyXxfu5pfWkrYcMdjWG. Gib ihn an, wenn du den Support zu einer bestimmten Anfrage kontaktierst. Siehe Request-ID.
anthropic-organization-idDie ID der Organisation, zu der der in der Anfrage verwendete API-Key oder das Zugriffstoken gehört.
anthropic-workspace-idDie mit wrkspc_ präfixierte ID des Workspace, auf den der API-Key oder das Zugriffstoken aufgelöst wurde, wie wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ, auch wenn dies der Standard-Workspace deiner Organisation ist. Fehlt, wenn die Anmeldeinformation nicht auf einen Workspace aufgelöst wird (zum Beispiel bei Admin-API-Anfragen) oder die Anfrage fehlschlägt, bevor die Authentifizierung abgeschlossen ist. Siehe Den Workspace hinter einer API-Antwort identifizieren.

Für die Ratenlimit-Header siehe Antwort-Header in Ratenlimits. Für Beispiele, die einen Antwort-Header nach Namen mit jedem SDK lesen, siehe Den Workspace hinter einer API-Antwort identifizieren.

Paginierung

List-Endpunkte geben Ergebnisse in Seiten zurück. Die meisten neueren List-Endpunkte verwenden das in diesem Abschnitt beschriebene page- und next_page-Cursor-Schema. Einige verwenden ein anderes Schema; siehe den Hinweis am Ende dieses Abschnitts. Verwende den limit-Abfrageparameter, um die Seitengröße zu steuern, und den page-Abfrageparameter, um eine benachbarte Seite abzurufen. Jede Antwort enthält ein data-Array neben Cursor-Feldern zum Navigieren zwischen Seiten.

NameOrtBeschreibung
limitAbfrageparameterMaximale Anzahl der pro Seite zurückzugebenden Elemente.
pageAbfrageparameterUndurchsichtiger Cursor aus einer vorherigen Antwort. Übergib hier einen next_page- oder prev_page-Wert, um die benachbarte Seite abzurufen.
orderAbfrageparameterSortierrichtung für die Ergebnisse (asc oder desc), bei List-Endpunkten, die Sortierung unterstützen. Ein page-Cursor ist nur mit der order gültig, mit der er erstellt wurde.
next_pageAntwortfeldCursor für die nächste Seite oder null, wenn es keine weiteren Ergebnisse gibt.
prev_pageAntwortfeldCursor für die vorherige Seite bei Endpunkten, die Rückwärtspaginierung unterstützen (derzeit GET /v1/sessions), oder null, wenn du dich auf der ersten Seite befindest. Andere List-Endpunkte lassen das Feld weg.

Um eine Seite zurückzugehen, übergib prev_page als page-Parameter. prev_page ist null, wenn du dich auf der ersten Seite befindest. Nicht alle List-Endpunkte unterstützen prev_page. Nur GET /v1/sessions gibt prev_page zurück; bei List-Endpunkten, die keine Rückwärtspaginierung unterstützen, fehlt das Feld in der Antwort, anstatt null zu sein. Für eine Anfrage-Durchführung siehe Sessions auflisten.

Das SDK stellt einen automatisch paginierenden Iterator bereit, der next_page für dich verfolgt. Zum Beispiel durchläuft for session in client.beta.sessions.list() jede Session. Die automatische Paginierung des SDK funktioniert nur vorwärts; um eine Seite zurückzugehen, lies prev_page aus der Antwort und übergib es selbst als page-Parameter. Details findest du unter SDKs, CLI und Bibliotheken.

Ratenlimits und Verfügbarkeit

Ratenlimits

Die API erzwingt Ratenlimits und Ausgabenlimits, um Missbrauch zu verhindern und die Kapazität zu verwalten. Limits sind in Nutzungsstufen organisiert; deine Organisation wird automatisch einer Stufe zugeordnet und kann im Laufe der Zeit zu einer höheren Stufe wechseln. Jede Stufe hat:

  • Ausgabenlimits: Maximale monatliche Kosten für die API-Nutzung
  • Ratenlimits: Maximale Anzahl von Anfragen pro Minute (RPM) und Token pro Minute (TPM)

Deine Ratenlimits kannst du unter Ratenlimits in der Claude Console einsehen. Deine Ausgabenlimits findest du unter Ausgabenlimits in der Claude Console (platform.claude.com/settings/spend-limits). Für höhere Ratenlimits oder eine höhere monatliche Ausgabenobergrenze verwende Höhere Stufe anfragen auf der Seite Ratenlimits.

Für detaillierte Informationen über Limits, Stufen und den für die Ratenbegrenzung verwendeten Token-Bucket-Algorithmus siehe Ratenlimits.

Verfügbarkeit

Die Claude API ist in vielen Ländern und Regionen weltweit verfügbar. Überprüfe die Seite der unterstützten Regionen, um die Verfügbarkeit an deinem Standort zu bestätigen.

Nächste Schritte

Vollständige API-Spezifikation für direkte Modellinteraktionen

Agents-, Sessions- und Environments-Endpunkte

Python, TypeScript, C#, Go, Java, PHP und Ruby

Nutzungsstufen, Anfordern höherer Limits und der Token-Bucket-Algorithmus

War diese Seite hilfreich?