API-ReferenzAPI verwenden

API-Übersicht

Copy page



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:

• 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:

• 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 % Kostenreduktion (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 ihre Details auf (GET /v1/models)
• Files API: Lade Dateien hoch und verwalte sie zur Verwendung über mehrere API-Aufrufe hinweg (POST /v1/files, GET /v1/files)
• Skills API: Erstelle und verwalte benutzerdefinierte Agenten-Skills (POST /v1/skills, GET /v1/skills)

Die folgenden APIs befinden sich in der Beta-Phase:

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

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

Authentifizierung

Details zu jeder Authentifizierungsmethode und wann du sie verwenden solltest, findest du unter Authentifizierung. Anfragen an die Claude API enthalten diese Header:

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 erfordert. 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 webbasierte Console bereitgestellt. Du kannst den playground verwenden, um die API im Browser auszuprobieren, und anschließend API-Keys in den Kontoeinstellungen generieren. Du wählst den Typ jedes Keys (siehe Key-Typen) und seinen Ablauf bei der Erstellung. Verwende Workspaces, um Umgebungen zu trennen und Ausgaben zu kontrollieren – je 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
• Anfrage-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, der Funktionsverfügbarkeit, Compliance-Anforderungen und Preispräferenzen.

Claude API

• Direkter Zugriff auf die neuesten Modelle und Funktionen
• Abrechnung und Support durch Anthropic
• 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 Zeitplanung.
• 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-Fehler request_too_large.

Antwort-Header

Die Claude API fügt ihren Antworten die folgenden Header hinzu:

Zu den Ratenlimit-Headern siehe Antwort-Header unter Ratenlimits. Beispiele, die mit jedem SDK einen Antwort-Header anhand seines Namens auslesen, findest du unter Den Workspace hinter einer API-Antwort identifizieren.

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 sowie Cursor-Felder zur Navigation 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 eine Anfrage findest du unter Sitzungen auflisten.

Jedes SDK bietet einen automatisch paginierenden Iterator, der next_page für dich verfolgt. 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 Paginierung der SDKs funktioniert nur vorwärts; um eine Seite zurückzugehen, lies prev_page aus der Antwort und übergib es selbst als page-Parameter. Siehe Client-SDKs für sprachspezifische Details.

Ratenlimits und Verfügbarkeit

Ratenlimits

Die API setzt „rate limits“ (Ratenlimits) und Ausgabenlimits durch, um Missbrauch zu verhindern und Kapazitäten zu verwalten. Die Limits sind in Nutzungsstufen organisiert; deine Organisation wird automatisch einer Stufe zugeordnet und kann im Laufe der Zeit in eine höhere Stufe aufsteigen. 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 deine Ratenlimits auf der Seite Ratenlimits und deine Ausgabenlimits auf der Seite Abrechnung in der Console einsehen. Für höhere Ratenlimits oder eine höhere monatliche Ausgabenobergrenze verwende Request rate limit increase auf der Seite Ratenlimits.

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

Verfügbarkeit

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

Nächste Schritte