Claude su Vertex AI

L'API Vertex per accedere a Claude è quasi identica all'API Messages e supporta tutte le stesse opzioni, con due differenze fondamentali:

• In Vertex, model non viene passato nel corpo della richiesta. Invece, viene specificato nell'URL dell'endpoint di Google Cloud.
• In Vertex, anthropic_version viene passato nel corpo della richiesta (piuttosto che come intestazione) e deve essere impostato al valore vertex-2023-10-16.

Vertex è supportato anche dagli SDK client ufficiali di Anthropic. Questa guida ti guiderà attraverso il processo di effettuazione di una richiesta a Claude su Vertex AI in Python o TypeScript.

Nota che questa guida presuppone che tu abbia già un progetto GCP in grado di utilizzare Vertex AI. Vedi utilizzo dei modelli Claude 3 di Anthropic per ulteriori informazioni sulla configurazione richiesta, nonché una procedura dettagliata completa.

Installa un SDK per accedere a Vertex AI

Innanzitutto, installa l'SDK client di Anthropic per il linguaggio di tua scelta.

Accesso a Vertex AI

Disponibilità del modello

Nota che la disponibilità del modello Anthropic varia in base alla regione. Cerca "Claude" in Vertex AI Model Garden oppure vai a Usa Claude 3 per le informazioni più recenti.

ID modello API

Effettuazione di richieste

Prima di eseguire le richieste, potrebbe essere necessario eseguire gcloud auth application-default login per autenticarsi con GCP.

L'esempio seguente mostra come generare testo da Claude su Vertex AI:

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-opus-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulta i nostri SDK client e la documentazione ufficiale di Vertex AI per ulteriori dettagli.

Claude è disponibile anche tramite Amazon Bedrock e Microsoft Foundry.

Registrazione dell'attività

Vertex fornisce un servizio di registrazione delle richieste-risposte che consente ai clienti di registrare i prompt e i completamenti associati al tuo utilizzo.

Anthropic consiglia di registrare la tua attività su almeno una base mobile di 30 giorni per comprendere la tua attività e indagare su eventuali usi impropri.

Supporto delle funzionalità

Puoi trovare tutte le funzionalità attualmente supportate su Vertex qui.

Endpoint globali e regionali

A partire da Claude Sonnet 4.5 e tutti i modelli futuri, Google Vertex AI offre due tipi di endpoint:

• Endpoint globali: Routing dinamico per la massima disponibilità
• Endpoint regionali: Routing dei dati garantito attraverso regioni geografiche specifiche

Gli endpoint regionali includono un premio di prezzo del 10% rispetto agli endpoint globali.

Quando utilizzare ciascuna opzione

Endpoint globali (consigliato):

• Forniscono la massima disponibilità e tempo di attività
• Instradano dinamicamente le richieste alle regioni con capacità disponibile
• Nessun premio di prezzo
• Migliore per le applicazioni in cui la residenza dei dati è flessibile
• Supporta solo il traffico pay-as-you-go (il throughput con provisioning richiede endpoint regionali)

Endpoint regionali:

• Instradano il traffico attraverso regioni geografiche specifiche
• Richiesti per i requisiti di residenza dei dati e conformità
• Supportano sia il traffico pay-as-you-go che il throughput con provisioning
• Il premio di prezzo del 10% riflette i costi dell'infrastruttura per la capacità regionale dedicata

Implementazione

Utilizzo di endpoint globali (consigliato):

Imposta il parametro region su "global" quando inizializzi il client:

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-opus-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Utilizzo di endpoint regionali:

Specifica una regione specifica come "us-east1" o "europe-west1":

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-opus-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Risorse aggiuntive

• Prezzi di Google Vertex AI: cloud.google.com/vertex-ai/generative-ai/pricing
• Documentazione dei modelli Claude: Claude su Vertex AI
• Post del blog di Google: Endpoint globale per i modelli Claude
• Dettagli sui prezzi di Anthropic: Documentazione sui prezzi