API Vertex AI

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

• 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 (anziché come header), e deve essere impostato al valore vertex-2023-10-16.

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

Nota che questa guida presuppone che tu abbia già un progetto GCP che è in grado di utilizzare Vertex AI. Vedi utilizzare i modelli Claude 3 di Anthropic per maggiori informazioni sulla configurazione richiesta, così come una procedura completa.

​

Installare un SDK per accedere a Vertex AI

Prima, installa l’SDK client di Anthropic per il linguaggio di tua scelta.

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

​

Accedere a Vertex AI

​

Disponibilità del Modello

Nota che la disponibilità dei modelli Anthropic varia per regione. Cerca “Claude” nel Vertex AI Model Garden o vai a Usa Claude 3 per le informazioni più aggiornate.

​

Nomi dei modelli API

​

Effettuare richieste

Prima di eseguire le richieste potresti dover eseguire gcloud auth application-default login per autenticarti con GCP.

I seguenti esempi mostrano come generare testo da Claude su Vertex AI:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
# Dove il modello è in esecuzione
region = "us-east5"

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

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

Vedi i nostri SDK client e la documentazione ufficiale di Vertex AI per maggiori dettagli.

​

Registrazione delle attività

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

Anthropic raccomanda di registrare la tua attività almeno su base continuativa di 30 giorni per comprendere la tua attività e investigare qualsiasi potenziale uso improprio.

​

Supporto delle funzionalità

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