Claude Models on Google Cloud (Google managed)

Claude Models on Google Cloud compare les deux offres Google Cloud. Elle indique également comment savoir laquelle vous utilisez.

Avant d'effectuer des appels API

Pour utiliser Claude Models on Google Cloud (Google managed), vous avez besoin de :

1. Un projet Google Cloud pouvant utiliser Agent Platform. Pour les étapes de configuration, consultez la page Anthropic Claude models on Agent Platform de Google Cloud.
2. La CLI gcloud installée, pour le développement local.
3. Pour l'identité qui effectue les appels, un rôle IAM incluant l'autorisation aiplatform.endpoints.predict, tel qu'Agent Platform User (roles/aiplatform.user). Pour plus de détails, consultez la page Agent Platform partner models de Google Cloud.
4. Des identifiants Google Cloud pour cette identité. Pour les exemples de SDK, vous devrez peut-être exécuter gcloud auth application-default login pour vous authentifier auprès de Google Cloud. Les exemples cURL pour Claude Models on Google Cloud (Google managed) obtiennent leur jeton avec gcloud auth print-access-token. Cette commande utilise la connexion propre à la CLI gcloud, et non les Application Default Credentials. Pour ces exemples, exécutez d'abord gcloud auth login ou gcloud init.

Installer un SDK

Les SDK clients d'Anthropic prennent en charge Claude Models on Google Cloud (Google managed) via AnthropicVertex. Installez le paquet qui le fournit :

pip install -U "anthropic[vertex]"

La CLI ant ne prend pas en charge Claude Models on Google Cloud (Google managed).

Effectuer des requêtes

Les requêtes vers Claude Models on Google Cloud (Google managed) sont envoyées à une URL de point de terminaison Agent Platform qui se termine par :rawPredict. Les requêtes en « streaming » (transmission en flux) utilisent plutôt :streamRawPredict.

Une requête est presque identique à une requête de l'API Messages. Elle en diffère de deux manières principales :

• Modèle : L'URL du point de terminaison désigne le modèle. Dans une requête cURL, omettez model du corps.
• Version : Dans une requête cURL, transmettez anthropic_version dans le corps, et non comme en-tête. Définissez-le sur vertex-2023-10-16, ou sur la version d'API 2026-10-21.

Les exemples suivants utilisent le point de terminaison global. Pour les autres types de points de terminaison, consultez Points de terminaison globaux, multirégionaux et régionaux.

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

ID de modèles de l'API

Claude Models on Google Cloud (Google managed) propose différents modèles Claude selon les régions. Pour vérifier quels modèles une région propose, recherchez « Claude » dans Model Garden ou consultez la page Anthropic Claude models on Agent Platform de Google Cloud.

Google fixe les dates de cycle de vie des modèles servis par Claude Models on Google Cloud (Google managed). Ces dates peuvent différer du calendrier de l'API Claude. Pour connaître la date de retrait actuelle d'un modèle, consultez la page Anthropic Claude models on Agent Platform de Google Cloud. Pour la signification de « déprécié » et « retiré », consultez Dépréciations de modèles.

Points de terminaison globaux, multirégionaux et régionaux

Claude Models on Google Cloud (Google managed) propose trois types de points de terminaison. Vous en choisissez un avec la valeur de région que vous transmettez lors de la création du client. Dans une requête cURL, le type de point de terminaison détermine l'hôte et le segment locations de l'URL.

Les types de points de terminaison diffèrent selon l'endroit où ils envoient les requêtes :

• Global : Les requêtes sont envoyées vers n'importe quelle région disposant de capacité disponible. Utilisez-le lorsque vous souhaitez une disponibilité maximale et que la résidence des données est flexible.
• Multirégional : Les requêtes sont envoyées vers n'importe quelle région des États-Unis ("us") ou de l'Union européenne ("eu"). Utilisez-le lorsque vous avez besoin d'une résidence des données au sein d'une vaste zone géographique et d'une disponibilité supérieure à celle d'une seule région.
• Régional : Les requêtes sont envoyées uniquement vers la région que vous indiquez, telle que "us-east5" ou "europe-west1". Utilisez-le lorsque vous avez besoin d'une résidence des données dans une seule région ou devez respecter des exigences de conformité strictes.

Les points de terminaison multirégionaux et régionaux coûtent 10 % de plus que les points de terminaison globaux. Les trois types de points de terminaison acceptent le trafic à l'usage, et le débit provisionné nécessite un point de terminaison régional.

Les points de terminaison régionaux servent uniquement Claude Sonnet 4.6 et les modèles antérieurs. Pour les modèles plus récents, utilisez un point de terminaison global ou multirégional.

Les exemples suivants utilisent le point de terminaison multirégional us. Les lignes mises en évidence définissent la région. Pour une requête complète sur le point de terminaison global, consultez Effectuer des requêtes.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

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

Fonctionnalités prises en charge

Les fonctionnalités prises en charge sur Claude Models on Google Cloud (Google managed) incluent les suivantes :

• API Messages
• « Prompt caching » (mise en cache des prompts)
• « Thinking » (réflexion)
• « Tool use » (utilisation d'outils), y compris ces outils :
  • Outil Bash
  • Outil d'utilisation du navigateur
  • Outil d'utilisation de l'ordinateur
  • Outil de mémoire
  • Outil d'édition de texte
  • Outil de recherche web
• Citations
• Sorties structurées

La vue d'ensemble des fonctionnalités répertorie chaque fonctionnalité et indique si Claude Models on Google Cloud (Google managed) la prend en charge.

Fonctionnalités non prises en charge

Claude Models on Google Cloud (Google managed) ne prend pas en charge les éléments suivants :

• Sources d'entrée : Les sources URL pour les images et les documents, ainsi que la Files API
• Outils côté serveur : L'exécution de code, la récupération web et l'advisor
• Infrastructure d'agents : Agent Skills, le connecteur MCP et l'appel d'outils programmatique
• Points de terminaison de l'API : Message Batches API, Models API, Admin API, Compliance API et Usage and Cost API
• Claude Managed Agents
• Repli côté serveur : Le paramètre fallbacks

Au lieu du repli côté serveur, utilisez le modèle de repli côté client.

Fenêtre de contexte

Claude Models on Google Cloud (Google managed) offre une « context window » (fenêtre de contexte) de 1M tokens pour ces modèles :

• Claude Fable 5.1
• Claude Fable 5
• Claude Opus 5.5
• Claude Opus 5
• Claude Opus 4.8
• Claude Opus 4.7
• Claude Opus 4.6
• Claude Sonnet 5.5
• Claude Sonnet 5
• Claude Sonnet 4.6
• Claude Haiku 5.5

Les autres modèles Claude disposent d'une fenêtre de contexte de 200k tokens. Ceux-ci incluent Claude Sonnet 4.5 (déprécié) et Claude Sonnet 4 (déprécié).

Agent Platform limite la taille des charges utiles des requêtes à 30 Mo. Lorsque vous envoyez des documents volumineux ou de nombreuses images, vous pourriez atteindre cette limite avant la limite de tokens.

Facturation, limites de débit et journalisation

Limites de débit

Google Cloud gère les « rate limits » (limites de débit) et les quotas pour Claude Models on Google Cloud (Google managed). Pour plus de détails, notamment sur la manière de demander une augmentation de quota, consultez la page Quotas for Anthropic Claude models de Google Cloud.

Facturation

Google Cloud vous facture Claude Models on Google Cloud (Google managed). Pour les prix, consultez la page Generative AI pricing de Google Cloud. Les prix dépendent également du type de point de terminaison. Consultez Points de terminaison globaux, multirégionaux et régionaux.

Conservation des données

Google Cloud régit le traitement des données pour Claude Models on Google Cloud (Google managed). Pour plus de détails, consultez Agent Platform and zero data retention.

Surveillance et journalisation

Pour journaliser les prompts et les complétions pour Claude Models on Google Cloud (Google managed), utilisez le service de journalisation des requêtes et réponses d'Agent Platform.

Anthropic vous recommande de conserver au moins les 30 derniers jours de journaux. Les journaux vous aident à comprendre votre activité et à enquêter sur d'éventuels abus.

Migrer depuis Claude Models on Google Cloud (Anthropic managed)

Pour savoir ce qui change lors de la migration, consultez Différences entre les deux offres Google Cloud. Pour passer à Claude Models on Google Cloud (Google managed), suivez ces étapes :

1. 1

   Configurer l'accès

   Vérifiez que votre projet et l'identité qui effectue les appels répondent aux exigences de la section Avant d'effectuer des appels API.

2. 2

   Installer le paquet SDK

   Installez le paquet qui fournit le client pour Claude Models on Google Cloud (Google managed). Consultez Installer un SDK.

3. 3

   Remplacer l'import et le client

   Modifiez le code qui importe et crée votre client. Utilisez AnthropicVertex à la place de AnthropicGoogleCloud. Une requête cURL nécessite une nouvelle URL, de nouveaux en-têtes et un nouveau corps. Le code suivant crée le client pour Claude Models on Google Cloud (Anthropic managed) que vous utilisez aujourd'hui :

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   Le code suivant crée le client pour Claude Models on Google Cloud (Google managed). Il utilise le point de terminaison global. Pour les autres types de points de terminaison, consultez Points de terminaison globaux, multirégionaux et régionaux.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   Ce code transmet l'ID de votre projet et une région lors de la création du client. Remplacez MY_PROJECT_ID par l'ID de votre projet. Les appels à l'API Messages que vous effectuez avec le client restent inchangés. Les exceptions sont les ID de modèles et les fonctionnalités abordés à l'étape suivante.

4. 4

   Vérifier les ID de modèles et les fonctionnalités

   • ID de modèles : Si vous utilisez un modèle antérieur à Claude 4.6, remplacez le trait d'union précédant la date de l'instantané dans son ID par @. Par exemple, claude-haiku-4-5-20251001 devient claude-haiku-4-5@20251001. Pour les modèles et leurs ID, consultez ID de modèles de l'API.
   • Fonctionnalités : Vérifiez que les fonctionnalités utilisées par votre code ne figurent pas dans Fonctionnalités non prises en charge.
5. 5

   Exécuter une requête de test

   Exécutez la requête de la section Effectuer des requêtes pour vérifier que votre configuration fonctionne. Exécutez ensuite votre propre code. Avant de migrer le trafic de production, renseignez-vous sur les limites de débit pour Claude Models on Google Cloud (Google managed).

Étapes suivantes