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

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

Verfügbare APIs

Die Claude API umfasst die folgenden APIs:

• Messages API: Sende Nachrichten an Claude für dialogorientierte 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 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)

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:

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. Du kannst das Playground verwenden, um die API im Browser auszuprobieren, und dann API-Keys in den Kontoeinstellungen generieren (siehe Hol dir deinen Claude API-Key). Du wählst den Typ jedes Keys (siehe Key-Typen) und seine Ablaufzeit bei der Erstellung aus. Verwende Workspaces, um Umgebungen zu trennen 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 (Authentifizierung, anthropic-version, content-type)
• Typsichere Anfrage- und Antwortbehandlung
• Integrierte Wiederholungslogik und Fehlerbehandlung
• Streaming-Unterstützung
• Anfrage-Timeouts und Verbindungsverwaltung

Für eine Liste der Client-SDKs siehe 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ä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 und Microsoft Foundry; von Partnern betriebene Plattformen umfassen Amazon Bedrock und Google Cloud. 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

Anfrage- und Antwortformat

Anfragegrößenlimits

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:

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.

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.

Jedes SDK bietet einen automatisch paginierenden Iterator, der next_page für dich verfolgt. In Python und TypeScript erhältst du ihn, indem du das List-Ergebnis direkt iterierst. Die anderen SDKs stellen den Iterator über eine separate Methode bereit. Die SDK-Auto-Paginierung ist nur vorwärtsgerichtet; 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 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)

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 Ratenlimit-Erhöhung anfordern 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