Claude auf Vertex AI

Die Vertex API für den Zugriff auf Claude ist nahezu identisch mit der Messages API und unterstützt alle gleichen Optionen, mit zwei wichtigen Unterschieden:

In Vertex wird model nicht im Request-Body übergeben. Stattdessen wird es in der Google Cloud Endpoint-URL angegeben.
In Vertex wird anthropic_version im Request-Body übergeben (nicht als Header), und muss auf den Wert vertex-2023-10-16 gesetzt werden.

Vertex wird auch von Anthropics offiziellen Client SDKs unterstützt. Diese Anleitung führt Sie durch den Prozess, eine Anfrage an Claude auf Vertex AI entweder in Python oder TypeScript zu stellen.

Beachten Sie, dass diese Anleitung davon ausgeht, dass Sie bereits ein GCP-Projekt haben, das Vertex AI verwenden kann. Siehe Verwendung der Claude 3 Modelle von Anthropic für weitere Informationen zur erforderlichen Einrichtung sowie eine vollständige Anleitung.

Installieren Sie ein SDK für den Zugriff auf Vertex AI

Installieren Sie zunächst das Client SDK von Anthropic für Ihre Sprache der Wahl.

pip install -U google-cloud-aiplatform "anthropic[vertex]"

Zugriff auf Vertex AI

Modellverfügbarkeit

Beachten Sie, dass die Verfügbarkeit von Anthropic-Modellen je nach Region variiert. Suchen Sie nach "Claude" im Vertex AI Model Garden oder gehen Sie zu Claude 3 verwenden für die neuesten Informationen.

API-Modell-IDs

Modell	Vertex AI API-Modell-ID
Claude Sonnet 4.5	claude-sonnet-4-5@20250929
Claude Sonnet 4	claude-sonnet-4@20250514
Claude Sonnet 3.7 ⚠️	claude-3-7-sonnet@20250219
Claude Opus 4.5	claude-opus-4-5@20251101
Claude Opus 4.1	claude-opus-4-1@20250805
Claude Opus 4	claude-opus-4@20250514
Claude Opus 3 ⚠️	claude-3-opus@20240229
Claude Haiku 4.5	claude-haiku-4-5@20251001
Claude Haiku 3.5 ⚠️	claude-3-5-haiku@20241022
Claude Haiku 3	claude-3-haiku@20240307

Anfragen stellen

Bevor Sie Anfragen ausführen, müssen Sie möglicherweise gcloud auth application-default login ausführen, um sich bei GCP zu authentifizieren.

Das folgende Beispiel zeigt, wie Sie Text von Claude auf Vertex AI generieren:

Weitere Details finden Sie in unseren Client SDKs und der offiziellen Vertex AI Dokumentation.

Aktivitätsprotokollierung

Vertex bietet einen Request-Response-Protokollierungsdienst, 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 Missbrauchsfälle zu untersuchen.

Das Aktivieren dieses Dienstes gibt Google oder Anthropic keinen Zugriff auf Ihren Inhalt.

Funktionsunterstützung

Sie können alle derzeit auf Vertex unterstützten Funktionen hier finden.

Globale vs. regionale Endpoints

Ab Claude Sonnet 4.5 und allen zukünftigen Modellen bietet Google Vertex AI zwei Endpoint-Typen:

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

Regionale Endpoints beinhalten einen 10%-igen Preisaufschlag gegenüber globalen Endpoints.

Dies gilt nur für Claude Sonnet 4.5 und zukünftige Modelle. Ältere Modelle (Claude Sonnet 4, Opus 4 und früher) behalten ihre bestehenden Preisstrukturen bei.

Wann sollte man jede Option verwenden

Globale Endpoints (empfohlen):

Bieten maximale Verfügbarkeit und Betriebszeit
Leiten Anfragen dynamisch zu Regionen mit verfügbarer Kapazität weiter
Kein Preisaufschlag
Am besten für Anwendungen, bei denen Datenresidenz flexibel ist
Unterstützt nur Pay-as-you-go-Verkehr (bereitgestellter Durchsatz erfordert regionale Endpoints)

Regionale Endpoints:

Leiten Verkehr durch spezifische geografische Regionen weiter
Erforderlich für Datenresidenz und Compliance-Anforderungen
Unterstützen sowohl Pay-as-you-go als auch bereitgestellten Durchsatz
10%-iger Preisaufschlag spiegelt Infrastrukturkosten für dedizierte regionale Kapazität wider

Implementierung

Verwendung globaler Endpoints (empfohlen):

Setzen Sie den region-Parameter auf "global" beim Initialisieren des Clients:

Verwendung regionaler Endpoints:

Geben Sie eine spezifische Region wie "us-east1" oder "europe-west1" an:

Zusätzliche Ressourcen

Google Vertex AI Preisgestaltung: cloud.google.com/vertex-ai/generative-ai/pricing
Claude Modelle Dokumentation: Claude auf Vertex AI
Google Blog-Beitrag: Globaler Endpoint für Claude Modelle
Anthropic Preisdetails: Preisdokumentation

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east1"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-sonnet-4-5@20250929",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)