Claude Models on Google Cloud (Google managed)

Claude Models on Google Cloud compara as duas ofertas do Google Cloud. Também mostra como identificar qual delas você usa.

Antes de fazer chamadas de API

Para usar o Claude Models on Google Cloud (Google managed), você precisa de:

1. Um projeto do Google Cloud que possa usar o Agent Platform. Para as etapas de configuração, consulte a página Anthropic Claude models on Agent Platform do Google Cloud.
2. A gcloud CLI instalada, para desenvolvimento local.
3. Para a identidade que faz as chamadas, um papel do IAM que inclua a permissão aiplatform.endpoints.predict, como Agent Platform User (roles/aiplatform.user). Para detalhes, consulte a página Agent Platform partner models do Google Cloud.
4. Credenciais do Google Cloud para essa identidade. Para os exemplos de SDK, talvez você precise executar gcloud auth application-default login para se autenticar no Google Cloud. Os exemplos de cURL para o Claude Models on Google Cloud (Google managed) obtêm seu token com gcloud auth print-access-token. Esse comando usa o login próprio da gcloud CLI, não o Application Default Credentials. Para esses exemplos, execute gcloud auth login ou gcloud init primeiro.

Instalar um SDK

Os SDKs de cliente da Anthropic oferecem suporte ao Claude Models on Google Cloud (Google managed) por meio de AnthropicVertex. Instale o pacote que o fornece:

pip install -U "anthropic[vertex]"

A CLI ant não oferece suporte ao Claude Models on Google Cloud (Google managed).

Fazendo requisições

As requisições ao Claude Models on Google Cloud (Google managed) vão para uma URL de endpoint do Agent Platform que termina em :rawPredict. As requisições de "streaming" (streaming) usam :streamRawPredict em vez disso.

Uma requisição é quase idêntica a uma requisição da Messages API. Ela difere de duas maneiras principais:

• Modelo: A URL do endpoint nomeia o modelo. Em uma requisição cURL, deixe model fora do corpo.
• Versão: Em uma requisição cURL, passe anthropic_version no corpo, não como cabeçalho. Defina-o como vertex-2023-10-16 ou como a versão da API 2026-10-21.

Os exemplos a seguir usam o endpoint global. Para os outros tipos de endpoint, consulte Endpoints globais, multirregionais e regionais.

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)

IDs de modelo da API

O Claude Models on Google Cloud (Google managed) oferece diferentes modelos Claude em diferentes regiões. Para verificar quais modelos uma região oferece, pesquise "Claude" no Model Garden ou consulte a página Anthropic Claude models on Agent Platform do Google Cloud.

O Google define as datas de ciclo de vida dos modelos que o Claude Models on Google Cloud (Google managed) disponibiliza. Essas datas podem diferir do cronograma da Claude API. Para a data atual de "retirement" (desativação) de um modelo, consulte a página Anthropic Claude models on Agent Platform do Google Cloud. Para saber o que significam Descontinuado e Desativado, consulte Descontinuações de modelos.

Endpoints globais, multirregionais e regionais

O Claude Models on Google Cloud (Google managed) oferece três tipos de endpoint. Você escolhe um com o valor de região que passa ao criar o cliente. Em uma requisição cURL, o tipo de endpoint define o host e o segmento locations da URL.

Os tipos de endpoint diferem quanto ao destino das requisições:

• Global: As requisições vão para qualquer região com capacidade disponível. Use-o quando quiser disponibilidade máxima e a residência de dados for flexível.
• Multirregional: As requisições vão para qualquer região nos Estados Unidos ("us") ou na União Europeia ("eu"). Use-o quando precisar de residência de dados dentro de uma área geográfica ampla e de maior disponibilidade do que uma única região.
• Regional: As requisições vão apenas para a região que você nomear, como "us-east5" ou "europe-west1". Use-o quando precisar de residência de dados em uma única região ou tiver que cumprir exigências rigorosas de conformidade.

Endpoints multirregionais e regionais custam 10% a mais do que endpoints globais. Os três tipos de endpoint aceitam tráfego pay-as-you-go, e o throughput provisionado requer um endpoint regional.

Os endpoints regionais disponibilizam apenas o Claude Sonnet 4.6 e modelos anteriores. Para modelos mais recentes, use um endpoint global ou multirregional.

Os exemplos a seguir usam o endpoint multirregional us. As linhas destacadas definem a região. Para uma requisição completa no endpoint global, consulte Fazendo requisições.

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)

Suporte a recursos

Os recursos compatíveis com o Claude Models on Google Cloud (Google managed) incluem os seguintes:

• Messages API
• "Prompt caching" (cache de prompt)
• Thinking
• "Tool use" (uso de ferramentas), incluindo estas ferramentas:
  • Ferramenta Bash
  • Ferramenta de uso de navegador
  • Ferramenta de uso de computador
  • Ferramenta de memória
  • Ferramenta de editor de texto
  • Ferramenta de pesquisa na web
• Citações
• Saídas estruturadas

A Visão geral de recursos lista todos os recursos e se o Claude Models on Google Cloud (Google managed) oferece suporte a cada um deles.

Recursos não suportados

O Claude Models on Google Cloud (Google managed) não oferece suporte ao seguinte:

• Fontes de entrada: Fontes de URL para imagens e documentos, e a Files API
• Ferramentas do lado do servidor: Execução de código, web fetch e advisor
• Infraestrutura de agentes: Agent Skills, conector MCP e chamada programática de ferramentas
• Endpoints de API: Message Batches API, Models API, Admin API, Compliance API e Usage and Cost API
• Claude Managed Agents
• Fallback do lado do servidor: O parâmetro fallbacks

Em vez do fallback do lado do servidor, use o padrão de fallback do lado do cliente.

Janela de contexto

O Claude Models on Google Cloud (Google managed) oferece uma "context window" (janela de contexto) de 1M de tokens para estes modelos:

• 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

Outros modelos Claude têm uma janela de contexto de 200k tokens. Entre eles estão o Claude Sonnet 4.5 (descontinuado) e o Claude Sonnet 4 (descontinuado).

O Agent Platform limita os payloads de requisição a 30 MB. Ao enviar documentos grandes ou muitas imagens, você pode atingir esse limite antes do limite de tokens.

Faturamento, limites de taxa e registro em log

Limites de taxa

O Google Cloud gerencia os "rate limits" (limites de taxa) e as cotas do Claude Models on Google Cloud (Google managed). Para detalhes, incluindo como solicitar um aumento de cota, consulte a página Quotas for Anthropic Claude models do Google Cloud.

Faturamento

O Google Cloud fatura o uso do Claude Models on Google Cloud (Google managed). Para os preços, consulte a página Generative AI pricing do Google Cloud. Os preços também dependem do tipo de endpoint. Consulte Endpoints globais, multirregionais e regionais.

Retenção de dados

O Google Cloud rege o tratamento de dados do Claude Models on Google Cloud (Google managed). Para detalhes, consulte Agent Platform and zero data retention.

Monitoramento e registro em log

Para registrar prompts e conclusões do Claude Models on Google Cloud (Google managed), use o serviço de registro de requisição-resposta do Agent Platform.

A Anthropic recomenda que você mantenha pelo menos os últimos 30 dias de logs. Os logs ajudam você a entender sua atividade e investigar possíveis usos indevidos.

Migrando do Claude Models on Google Cloud (Anthropic managed)

Para saber o que muda ao migrar, consulte Como as duas ofertas do Google Cloud diferem. Para migrar para o Claude Models on Google Cloud (Google managed), siga estas etapas:

1. 1

   Configurar o acesso

   Verifique se o seu projeto e a identidade que faz as chamadas atendem aos requisitos em Antes de fazer chamadas de API.

2. 2

   Instalar o pacote do SDK

   Instale o pacote que fornece o cliente para o Claude Models on Google Cloud (Google managed). Consulte Instalar um SDK.

3. 3

   Substituir a importação e o cliente

   Altere o código que importa e cria seu cliente. Use AnthropicVertex no lugar de AnthropicGoogleCloud. Uma requisição cURL precisa de uma nova URL, novos cabeçalhos e um novo corpo. O código a seguir cria o cliente para o Claude Models on Google Cloud (Anthropic managed) que você usa hoje:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   O código a seguir cria o cliente para o Claude Models on Google Cloud (Google managed). Ele usa o endpoint global. Para os outros tipos de endpoint, consulte Endpoints globais, multirregionais e regionais.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

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

   Esse código passa o ID do seu projeto e uma região ao criar o cliente. Substitua MY_PROJECT_ID pelo ID do seu projeto. As chamadas à Messages API que você faz com o cliente permanecem como estão. As exceções são os IDs de modelo e os recursos da próxima etapa.

4. 4

   Verificar IDs de modelo e recursos

   • IDs de modelo: Se você usa um modelo anterior ao Claude 4.6, substitua o hífen antes da data do snapshot em seu ID por @. Por exemplo, claude-haiku-4-5-20251001 se torna claude-haiku-4-5@20251001. Para os modelos e seus IDs, consulte IDs de modelo da API.
   • Recursos: Verifique se os recursos que seu código usa não estão listados em Recursos não suportados.
5. 5

   Executar uma requisição de teste

   Execute a requisição em Fazendo requisições para verificar se sua configuração funciona. Em seguida, execute seu próprio código. Antes de migrar o tráfego de produção, leia sobre os limites de taxa do Claude Models on Google Cloud (Google managed).

Próximos passos