Claude no Amazon Bedrock (Opus 4.7 e posteriores)

Este guia orienta você na configuração e na realização de chamadas de API para o Claude no Amazon Bedrock. O Claude no Amazon Bedrock é executado em infraestrutura gerenciada pela AWS com zero acesso de operador (o pessoal da Anthropic não tem acesso à infraestrutura de inferência), permitindo que você construa aplicações sensíveis inteiramente dentro do limite de segurança da AWS enquanto usa o mesmo formato da Messages API que você usa com a API de primeira parte da Anthropic.



Acesso

Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 e Claude Haiku 4.5 estão abertos a todos os clientes do Amazon Bedrock. O Claude Mythos Preview requer um convite; consulte Project Glasswing. Para disponibilidade por região, consulte Regiões.



Pré-requisitos

Antes de começar, certifique-se de que você tem:

• Uma conta AWS com acesso a modelos do Amazon Bedrock habilitado para os modelos Claude que você pretende usar.
• A AWS CLI instalada e configurada (opcional, para gerenciamento de credenciais).

O Claude Mythos Preview requer adicionalmente uma conta AWS dedicada que tenha sido incluída na lista de permissões pela equipe do Bedrock Marketplace. Seu executivo de contas da Anthropic pode enviar o ID da sua conta para inclusão na lista de permissões (normalmente processado em até 24 horas), e a AWS envia um e-mail de boas-vindas assim que for concluído.



Autenticação

O Claude no Amazon Bedrock suporta três caminhos de autenticação. Escolha o que melhor se adapta aos seus requisitos de segurança.



Service role do Bedrock (recomendado)

Use uma service role do Bedrock com chaves gerenciadas pela AWS para o acesso mais seguro e de longa duração:



Roles assumidas do IAM

Para acesso federado por identidade com uma sessão máxima de 12 horas:



Bearer tokens

Para acesso de curto prazo sem roles do IAM (máximo de 12 horas, opção menos preferida):



Instale um SDK

Os SDKs de cliente da Anthropic suportam o Claude no Amazon Bedrock através de um pacote ou módulo específico do Bedrock.

pip install -U "anthropic[bedrock]"



Fazendo sua primeira requisição

O endpoint segue o padrão https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Diferentemente da integração baseada em InvokeModel, este endpoint usa streaming SSE padrão e o mesmo formato de corpo de requisição da API de primeira parte da Anthropic.

O SDK resolve credenciais e região usando a precedência padrão da AWS: argumentos do construtor, depois variáveis de ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), depois o arquivo de configuração da AWS e a cadeia de credenciais (SSO, roles assumidas, role de tarefa do ECS, IMDS).

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'



Modelos suportados

Os IDs de modelo no Claude no Amazon Bedrock carregam um prefixo de provedor anthropic.. As capacidades e comportamentos dos modelos estão documentados na página de Visão geral dos modelos.



Suporte a recursos

Para a lista completa de recursos com disponibilidade no Amazon Bedrock, consulte a Visão geral de recursos.



Destaques de recursos suportados

• Messages API (/anthropic/v1/messages)
• Cache de prompt
• Pensamento estendido
• Uso de ferramentas, incluindo a ferramenta Bash, a ferramenta de uso de computador, a ferramenta de memória e a ferramenta de editor de texto
• Citações
• Saídas estruturadas



Recursos não suportados

• Fontes de entrada (fontes de URL para imagens e documentos, Files API)
• Ferramentas do lado do servidor (execução de código, busca na web, busca de páginas web, advisor)
• Infraestrutura de agentes (Agent Skills, conector MCP, chamada programática de ferramentas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback do lado do servidor (o parâmetro fallbacks; use o padrão de fallback do lado do cliente em vez disso)



Regiões

O Claude no Amazon Bedrock está disponível nas seguintes regiões da AWS. O Amazon Bedrock oferece dois tipos de endpoint:

• Global: roteamento dinâmico entre todas as regiões disponíveis para máxima disponibilidade. Sem acréscimo de preço.
• Regional: o endpoint resolve para a única região da AWS que você especificar, para requisitos de residência de dados. Endpoints regionais têm um acréscimo de preço de 10% em relação aos endpoints globais. Para rotear entre várias regiões dentro de uma geografia, use um perfil de inferência (US, EU, JP ou AU). As regiões marcadas como Apenas na região na tabela suportam roteamento direto de região única sem um perfil de inferência.

O endpoint global está disponível para Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 4.5. O Claude Mythos Preview é apenas regional e está disponível em us-east-1.



Cotas

A cota padrão é de 2 milhões de tokens de entrada por minuto (TPM). Você pode solicitar até 4 milhões de TPM de entrada sem aprovação adicional da Anthropic. A AWS impõe limites de requisições por minuto (RPM) do lado do Bedrock; entre em contato com o suporte da AWS para ajustes de RPM.



Retenção de dados

O tratamento de dados para esta oferta é regido pelo Amazon Bedrock. Para detalhes, consulte Proteção de dados no Amazon Bedrock.



Monitoramento e logging

O Claude no Amazon Bedrock emite logs tanto para o CloudWatch quanto para o CloudTrail. A Anthropic recomenda reter logs de atividade em uma base contínua de pelo menos 30 dias para entender padrões de uso e investigar possíveis problemas.



Suporte

Para suporte, entre em contato com [email protected]. Inclua o ID da sua conta AWS e o request-id de quaisquer respostas de API com falha.