API-Übersicht

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:

• Ein Claude Console-Konto
• Einen API-Key oder eine konfigurierte Workload Identity Federation-Regel

Eine Schritt-für-Schritt-Anleitung zur Einrichtung findest du unter Erste Schritte.



Verfügbare APIs

Die Claude API umfasst die folgenden APIs:

Allgemeine Verfügbarkeit:

• Messages API: Sende Nachrichten an Claude für konversationelle Interaktionen (POST /v1/messages)
• Message Batches API: Verarbeite große Mengen von Messages-Anfragen asynchron mit 50 % Kostenreduzierung (POST /v1/messages/batches)
• Token Counting API: Zähle Token in einer Nachricht vor dem Senden, um Kosten und Ratenlimits zu verwalten (POST /v1/messages/count_tokens)
• Models API: Liste verfügbare Claude-Modelle und deren Details auf (GET /v1/models)

Beta:

• Files API: Lade Dateien hoch und verwalte sie für die Verwendung über mehrere API-Aufrufe hinweg (POST /v1/files, GET /v1/files)
• Skills API: Erstelle und verwalte benutzerdefinierte Agent-Skills (POST /v1/skills, GET /v1/skills)
• Agents API: Definiere wiederverwendbare, versionierte Agenten-Konfigurationen für Claude Managed Agents (POST /v1/agents, GET /v1/agents)
• Sessions API: Führe zustandsbehaftete Agenten-Sessions in verwalteten Cloud-Sandboxes aus (POST /v1/sessions, GET /v1/sessions/{id}/stream)
• Environments API: Konfiguriere Sandbox-Vorlagen für Agenten-Sessions (POST /v1/environments, GET /v1/environments)

Die vollständige API-Referenz mit allen Endpunkten, Parametern und Response-Schemas findest du auf den API-Referenzseiten in der Navigation. Um auf Beta-Funktionen zuzugreifen, siehe Beta-Header.



Authentifizierung

Details zu beiden Authentifizierungsmethoden und wann welche zu verwenden ist, findest du unter Authentifizierung. Alle Anfragen an die Claude API müssen diese Header enthalten:

Wenn du die Client-SDKs verwendest, sendet das SDK diese Header automatisch. Details zur API-Versionierung findest du unter 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 Anmeldedatentypen, erforderliche Header und Authentifizierungsoptionen.



API-Keys erhalten

Die API wird über die Web-Console bereitgestellt. Du kannst die Workbench verwenden, um die API im Browser auszuprobieren, und dann API-Keys in den Kontoeinstellungen generieren. Verwende Workspaces, um deine API-Keys zu segmentieren und Ausgaben zu kontrollieren nach Anwendungsfall.



Client-SDKs

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

Vorteile:

• Automatische Header-Verwaltung (x-api-key, anthropic-version, content-type)
• Typsichere Verarbeitung von Anfragen und Antworten
• Integrierte Wiederholungslogik und Fehlerbehandlung
• Streaming-Unterstützung
• Request-Timeouts und Verbindungsverwaltung

Eine Liste der Client-SDKs findest du unter Client-SDKs.



Claude API vs. Cloud-Plattformen

Claude ist über die direkte 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ändigen Funktionszugriff, direkte Beziehung zu Anthropic



Cloud-Plattform-APIs

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

• Integriert in die Abrechnung und das IAM des Cloud-Anbieters
• Funktionsverfügbarkeit variiert je nach Plattform: Von Anthropic betriebene Plattformen umfassen Claude Platform on AWS und Microsoft Foundry; von Partnern betriebene Plattformen umfassen Amazon Bedrock und Google Cloud. Siehe die Seite der jeweiligen Plattform für Funktionsverfügbarkeit und Zeitplan.
• Am besten geeignet für: Bestehende Cloud-Verpflichtungen, spezifische Compliance-Anforderungen, konsolidierte Cloud-Abrechnung



Anfrage- und Antwortformat



Größenbeschränkungen für Anfragen

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



Response-Header

Die Claude API enthält in jeder Antwort die folgenden Header:

• request-id: Eine global eindeutige Kennung für die Anfrage
• anthropic-organization-id: Die Organisations-ID, die mit dem in der Anfrage verwendeten API-Key verknüpft ist



Paginierung

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

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ärts-Paginierung unterstützen, fehlt das Feld in der Antwort, anstatt null zu sein. Eine Schritt-für-Schritt-Anleitung für Anfragen findest du unter Sessions auflisten.

Jedes SDK bietet einen automatisch paginierenden Iterator, der next_page für dich folgt. In Python und TypeScript erhältst du ihn, indem du direkt über das List-Ergebnis iterierst. Die anderen SDKs stellen den Iterator über eine separate Methode bereit. Die automatische SDK-Paginierung funktioniert nur vorwärts; um eine Seite zurückzugehen, lies prev_page aus der Antwort und übergib es selbst als page-Parameter zurück. Siehe Client-SDKs für sprachspezifische Details.



Ratenlimits und Verfügbarkeit



Ratenlimits

Die API setzt Ratenlimits und Ausgabenlimits durch, um Missbrauch zu verhindern und Kapazität zu verwalten. Limits sind in Nutzungsstufen organisiert; deine Organisation wird automatisch einer Stufe zugeordnet und kann im Laufe der Zeit auf eine höhere 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)

Du kannst die aktuellen Limits deiner Organisation in der Console einsehen. Für höhere Limits verwende Request rate limit increase auf der Seite Limits.

Detaillierte Informationen zu Limits, Stufen und dem für das Ratenlimit verwendeten Token-Bucket-Algorithmus findest du unter Ratenlimits.



Verfügbarkeit

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



Nächste Schritte