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:

Allgemein verfügbar:

• 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 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}/stream)
• Environments API: Konfiguriere Sandbox-Vorlagen für Agent-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-Features 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.

Wenn du über eine Cloud-Plattform auf Claude zugreifst, ist die Authentifizierung in das IAM-System des Cloud-Anbieters integriert. Siehe die plattformspezifische Dokumentation für unterstützte Credential-Typen, erforderliche Header und Authentifizierungsoptionen.



API-Keys erhalten

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



Client-SDKs

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

Vorteile:

• Automatische Header-Verwaltung (x-api-key, anthropic-version, content-type)
• Typsichere Request- und Response-Verarbeitung
• Integrierte Retry-Logik 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, Feature-Verfügbarkeit, Compliance-Anforderungen und Preispräferenzen.



Claude API

• Direkter Zugriff auf die neuesten Modelle und Features
• Abrechnung und Support durch Anthropic
• Am besten geeignet für: Neue Integrationen, vollständigen Feature-Zugriff, 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
• Feature-Verfü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 Vertex AI. Siehe die jeweilige Plattformseite für Feature-Verfügbarkeit und Zeitplan.
• Am besten geeignet für: Bestehende Cloud-Verpflichtungen, spezifische Compliance-Anforderungen, konsolidierte Cloud-Abrechnung



Request- und Response-Format



Request-Größenlimits

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



Response-Header

Die Claude API enthält in jeder Response 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



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, die automatisch steigen, während du die API nutzt. 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 oder Priority Tier (erweiterte Service-Level mit zugesagten Ausgaben) kontaktiere den Vertrieb über die Console.

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



Verfügbarkeit

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



Nächste Schritte