Claude auf Amazon Bedrock

Das Aufrufen von Claude über Bedrock unterscheidet sich leicht davon, wie Sie Claude bei Verwendung der Client-SDKs von Anthropic aufrufen würden. Dieses Handbuch führt Sie durch die Durchführung eines API-Aufrufs an Claude auf Bedrock mit einem der Client-SDKs von Anthropic.

Beachten Sie, dass dieses Handbuch davon ausgeht, dass Sie sich bereits für ein AWS-Konto angemeldet haben und den programmatischen Zugriff konfiguriert haben.

Installieren und Konfigurieren der AWS CLI

1. Installieren Sie eine Version der AWS CLI in Version 2.13.23 oder neuer
2. Konfigurieren Sie Ihre AWS-Anmeldedaten mit dem AWS-Befehl „configure" (siehe Konfigurieren der AWS CLI) oder suchen Sie Ihre Anmeldedaten, indem Sie in Ihrem AWS-Dashboard zu „Command line or programmatic access" navigieren und den Anweisungen im Popup-Modal folgen.
3. Überprüfen Sie, dass Ihre Anmeldedaten funktionieren:

aws sts get-caller-identity

Installieren Sie ein SDK für den Zugriff auf Bedrock

Die Client-SDKs von Anthropic unterstützen Bedrock. Sie können auch direkt ein AWS SDK wie boto3 verwenden.

Zugriff auf Bedrock

Abonnieren Sie Anthropic-Modelle

Gehen Sie zur AWS Console > Bedrock > Model Access und fordern Sie Zugriff auf Anthropic-Modelle an. Beachten Sie, dass die Verfügbarkeit von Anthropic-Modellen je nach Region unterschiedlich ist. Siehe AWS-Dokumentation für die neuesten Informationen.

API-Modell-IDs

Weitere Informationen zu regionalen und globalen Modell-IDs finden Sie im Abschnitt Globale vs. regionale Endpunkte unten.

Verfügbare Modelle auflisten

Die folgenden Beispiele zeigen, wie Sie eine Liste aller Claude-Modelle ausgeben, die über Bedrock verfügbar sind:

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])

Anfragen stellen

Die folgenden Beispiele zeigen, wie Sie Text von Claude auf Bedrock generieren:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authentifizieren Sie sich, indem Sie die folgenden Schlüssel bereitstellen oder verwenden Sie die Standard-AWS-Anmeldedatenanbieter, z. B.
    # mit ~/.aws/credentials oder den Umgebungsvariablen "AWS_SECRET_ACCESS_KEY" und "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Temporäre Anmeldedaten können mit aws_session_token verwendet werden.
    # Weitere Informationen finden Sie 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 gestellt wird. Standardmäßig lesen wir AWS_REGION,
    # und wenn das nicht vorhanden ist, verwenden wir standardmäßig us-east-1. Beachten Sie, dass wir ~/.aws/config nicht für die Region lesen.
    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 finden Sie in den Client-SDKs und der offiziellen Bedrock-Dokumentation.

Bearer-Token-Authentifizierung

Sie können sich bei Bedrock mit Bearer-Tokens authentifizieren, anstatt AWS-Anmeldedaten zu verwenden. Dies ist in Unternehmensumgebungen nützlich, in denen Teams Zugriff auf Bedrock benötigen, ohne AWS-Anmeldedaten, IAM-Rollen oder Berechtigungen auf Kontoebene zu verwalten.

Der einfachste Ansatz besteht darin, die Umgebungsvariable AWS_BEARER_TOKEN_BEDROCK zu setzen, die automatisch von der fromEnv()-Anmeldedatenauflösung erkannt wird.

Um ein Token programmgesteuert bereitzustellen:

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

Aktivitätsprotokollierung

Bedrock bietet einen Invocation-Logging-Service, mit dem Kunden die Eingabeaufforderungen und Vervollständigungen protokollieren können, die mit Ihrer Nutzung verbunden sind.

Anthropic empfiehlt, dass Sie Ihre Aktivität mindestens auf einer 30-Tage-Rollbasis protokollieren, um Ihre Aktivität zu verstehen und mögliche Missbräuche zu untersuchen.

Funktionsunterstützung

Für alle derzeit unterstützten Funktionen auf Bedrock siehe API-Funktionsübersicht.

PDF-Unterstützung auf Bedrock

Die PDF-Unterstützung ist auf Amazon Bedrock über die Converse API und die InvokeModel API verfügbar. Detaillierte Informationen zu PDF-Verarbeitungsfunktionen und Einschränkungen finden Sie in der PDF-Unterstützungsdokumentation.

Wichtige Überlegungen für Converse API-Benutzer:

• Die visuelle PDF-Analyse (Diagramme, Bilder, Layouts) erfordert, dass Zitate aktiviert sind
• Ohne Zitate ist nur die grundlegende Textextraktion verfügbar
• Für vollständige Kontrolle ohne erzwungene Zitate verwenden Sie die InvokeModel API

Weitere Details zu den beiden Dokumentverarbeitungsmodi und ihren Einschränkungen finden Sie im PDF-Unterstützungsleitfaden.

Kontextfenster

Claude Opus 4.6 und Claude Sonnet 4.6 haben ein 1-Million-Token-Kontextfenster auf Amazon Bedrock. Andere Claude-Modelle, einschließlich Sonnet 4.5 und Sonnet 4 (veraltet), haben ein 200k-Token-Kontextfenster.

Amazon Bedrock begrenzt Anfrage-Payloads auf 20 MB. Beim Senden großer Dokumente oder vieler Bilder können Sie diese Grenze erreichen, bevor Sie die Token-Grenze erreichen.

Globale vs. regionale Endpunkte

Ab Claude Sonnet 4.5 und allen zukünftigen Modellen bietet Amazon Bedrock zwei Endpunkttypen:

• Globale Endpunkte: Dynamisches Routing für maximale Verfügbarkeit
• Regionale Endpunkte: Garantiertes Daten-Routing durch spezifische geografische Regionen

Regionale Endpunkte beinhalten einen 10%-Preisaufschlag gegenüber globalen Endpunkten.

Wann sollte jede Option verwendet werden

Globale Endpunkte (empfohlen):

• Bieten maximale Verfügbarkeit und Betriebszeit
• Leiten Anfragen dynamisch zu Regionen mit verfügbarer Kapazität weiter
• Kein Preisaufschlag
• Beste für Anwendungen, bei denen Datenresidenz flexibel ist

Regionale Endpunkte (CRIS):

• Leiten Datenverkehr durch spezifische geografische Regionen weiter
• Erforderlich für Datenresidenz und Compliance-Anforderungen
• Verfügbar für US, EU, Japan und Australien
• 10%-Preisaufschlag spiegelt Infrastrukturkosten für dedizierte regionale Kapazität wider

Implementierung

Verwendung globaler Endpunkte (Standard für Opus 4.6, Sonnet 4.5 und Sonnet 4 (veraltet)):

Die Modell-IDs für Claude Sonnet 4.5 und 4 (veraltet) 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, entfernen Sie das Präfix global. aus der Modell-ID:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Verwendung des US-Regionalendpunkts (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # Kein global. Präfix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Zusätzliche Ressourcen

• AWS Bedrock-Preisgestaltung: aws.amazon.com/bedrock/pricing
• AWS-Preisdokumentation: Bedrock-Preisleitfaden
• AWS-Blogbeitrag: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Anthropic-Preisdetails: Preisdokumentation