Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Der Aufruf von Claude über Bedrock unterscheidet sich leicht davon, wie du Claude direkt über die Claude API aufrufen würdest. Dieser Leitfaden führt dich durch einen API-Aufruf an Claude auf Bedrock mit einem der Client-SDKs von Anthropic.
Beachte, dass dieser Leitfaden davon ausgeht, dass du dich bereits für ein AWS-Konto registriert und den programmatischen Zugriff konfiguriert hast.
2.13.23 oder neuer.aws sts get-caller-identityDie Client-SDKs von Anthropic unterstützen Bedrock. Du kannst auch ein AWS-SDK wie boto3 direkt verwenden.
pip install -U "anthropic[bedrock]"Gehe zu AWS Console > Bedrock > Model Access und beantrage Zugriff auf Anthropic-Modelle. Beachte, dass die Verfügbarkeit von Anthropic-Modellen je nach Region variiert. Aktuelle Informationen findest du in der AWS-Dokumentation.
Lifecycle-Begriffe (Deprecated, Retired) sind unter Modell-Deprecations definiert. Lifecycle-Daten auf partnerbetriebenen Plattformen werden vom Partner festgelegt und können vom Zeitplan der Claude API abweichen. Das aktuelle Retirement-Datum eines Modells auf Amazon Bedrock findest du auf der Model-Lifecycle-Seite von Amazon Bedrock.
AWS bietet neuere Claude-Modelle über Cross-Region Inference (regionsübergreifende Inferenz) statt über On-Demand-Durchsatz an. Bei diesen Modellen schlägt eine Anfrage, die die Basis-Modell-ID übergibt, mit einem HTTP-400-Fehler wie dem folgenden fehl:
Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.Um diese Modelle aufzurufen, übergib ein Inference-Profil anstelle der Basis-Modell-ID. Die Inference-Profil-ID ist die Basis-Modell-ID mit einem Präfix aus einer Spalte, die in der folgenden Tabelle mit „Ja" markiert ist, zum Beispiel . Du kannst auch den vollständigen Inference-Profil-ARN in der Form arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id} übergeben. Die maßgebliche Liste der verfügbaren Inference-Profile von AWS findest du unter Supported Regions and models for inference profiles. Wie sich die Präfixe auf Routing und Preise auswirken, erfährst du im Abschnitt Globale versus regionale Endpunkte.
| Modell | Basis-Bedrock-Modell-ID | global | us | eu | jp | apac |
|---|---|---|---|---|---|---|
| Claude Opus 4.6 | Ja | Ja | Ja | Ja | Ja | |
| Claude Sonnet 4.6 | Ja | Ja | Ja | Ja | Nein | |
| Claude Sonnet 4.5 | Ja | Ja | Ja | Ja | Nein | |
| Claude Sonnet 4 Deprecated. | Ja | Ja | Ja | Nein | Ja | |
| Claude Sonnet 3.7 Retired. | Nein | Nein | Nein | Nein | Nein | |
| Claude Opus 4.5 | Ja | Ja | Ja | Nein | Nein | |
| Claude Opus 4.1 Deprecated. | Nein | Ja | Nein | Nein | Nein | |
| Claude Opus 4 Retired. | Nein | Nein | Nein | Nein | Nein | |
| Claude Haiku 4.5 | Ja | Ja | Ja | Nein | Nein | |
| Claude Haiku 3.5 Deprecated. | Nein | Ja | Nein | Nein | Nein |
Die folgenden Beispiele zeigen, wie du eine Liste aller über Bedrock verfügbaren Claude-Modelle ausgibst:
import boto3
bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")
for summary in response["modelSummaries"]:
print(summary["modelId"])Die folgenden Beispiele zeigen, wie du Text von Claude auf Bedrock generierst:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Authentifiziere dich, indem du entweder die Keys unten angibst oder die Standard-AWS-Credential-Provider verwendest, etwa
# über ~/.aws/credentials oder die Umgebungsvariablen "AWS_SECRET_ACCESS_KEY" und "AWS_ACCESS_KEY_ID".
aws_access_key="<access key>",
aws_secret_key="<secret key>",
# Temporäre Credentials können mit aws_session_token verwendet werden.
# Mehr dazu unter https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
aws_session_token="<session_token>",
# aws_region ändert die AWS-Region, an die die Anfrage gesendet wird. Standardmäßig liest das SDK AWS_REGION,
# und falls diese nicht gesetzt ist, wird us-east-1 verwendet. Beachte, dass das SDK ~/.aws/config nicht für die Region ausliest.
aws_region="us-west-2",
)
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)Weitere Details findest du in den Client-SDKs und in der offiziellen Bedrock-Dokumentation.
Du kannst dich bei Bedrock mit Bearer-Tokens anstelle von AWS-Anmeldedaten authentifizieren. Dies ist in Unternehmensumgebungen nützlich, in denen Teams Zugriff auf Bedrock benötigen, ohne AWS-Anmeldedaten, IAM-Rollen oder Berechtigungen auf Kontoebene verwalten zu müssen.
Der einfachste Ansatz ist, die Umgebungsvariable AWS_BEARER_TOKEN_BEDROCK zu setzen, die jedes SDK automatisch erkennt, wenn es Anmeldedaten aus der Umgebung auflöst.
Um ein Token programmatisch bereitzustellen:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
api_key="your-bearer-token",
aws_region="us-west-2",
)
message = client.messages.create(
model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Bedrock bietet einen Invocation-Logging-Service, mit dem du die Prompts und Completions protokollieren kannst, die mit deiner Nutzung verbunden sind.
Anthropic empfiehlt, deine Aktivität mindestens auf rollierender 30-Tage-Basis zu protokollieren, um deine Aktivität nachzuvollziehen und potenziellen Missbrauch zu untersuchen.
Die vollständige Feature-Liste mit Amazon-Bedrock-Verfügbarkeit findest du unter Features-Übersicht.
fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster)cache_control-Feld auf oberster Ebene; verwende stattdessen explizite Cache-Breakpoints)PDF-Unterstützung ist auf Bedrock sowohl über die Converse API als auch über die InvokeModel API verfügbar. Detaillierte Informationen zu PDF-Verarbeitungsfunktionen und -einschränkungen findest du unter Amazon Bedrock PDF-Unterstützung.
Wichtige Hinweise für Nutzer der Converse API:
Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 und Claude Sonnet 4.6 haben ein 1M-Token-Kontextfenster auf Amazon Bedrock. Andere Claude-Modelle, einschließlich Sonnet 4.5 und Sonnet 4 (deprecated), haben ein 200k-Token-Kontextfenster.
Bedrock begrenzt Request-Payloads auf 20 MB. Wenn du große Dokumente oder viele Bilder sendest, erreichst du dieses Limit möglicherweise vor dem Token-Limit.
Ab Claude Sonnet 4.5 und allen zukünftigen Modellen bietet Bedrock zwei Endpunkttypen:
Regionale Endpunkte beinhalten einen Preisaufschlag von 10 % gegenüber globalen Endpunkten.
Globale Endpunkte (empfohlen):
Regionale Endpunkte (CRIS):
Verwendung globaler Endpunkte (Standard für Opus 4.6, Sonnet 4.6 und Sonnet 4.5):
Die Modell-IDs für Claude Opus 4.6, Sonnet 4.6 und Sonnet 4.5 enthalten bereits das Präfix global.:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Verwendung regionaler Endpunkte (CRIS):
Um regionale Endpunkte zu verwenden, ersetze das Präfix global. durch ein regionales Präfix wie us.:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
# Verwendung des regionalen US-Endpunkts (CRIS)
message = client.messages.create(
model="us.anthropic.claude-opus-4-6-v1", # Regional prefix
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Was this page helpful?