Chamar Claude através do Bedrock difere ligeiramente de como você chamaria Claude ao usar os SDKs de cliente da Anthropic. Este guia o orientará através do processo de completar uma chamada de API para Claude no Bedrock em Python ou TypeScript. Observe que este guia assume que você já se inscreveu em uma conta AWS e configurou acesso programático.

Instalar e configurar a AWS CLI

  1. Instale uma versão da AWS CLI na versão 2.13.23 ou mais recente
  2. Configure suas credenciais AWS usando o comando AWS configure (consulte Configurar a AWS CLI) ou encontre suas credenciais navegando para “Command line or programmatic access” no seu painel AWS e seguindo as instruções no modal pop-up.
  3. Verifique se suas credenciais estão funcionando:
Shell
aws sts get-caller-identity

Instalar um SDK para acessar Bedrock

Os SDKs de cliente da Anthropic suportam Bedrock. Você também pode usar um SDK AWS como boto3 diretamente.
pip install -U "anthropic[bedrock]"

Acessando Bedrock

Inscrever-se em modelos Anthropic

Vá para AWS Console > Bedrock > Model Access e solicite acesso aos modelos Anthropic. Observe que a disponibilidade do modelo Anthropic varia por região. Consulte a documentação AWS para obter as informações mais recentes.

IDs de modelo de API

ModeloID de modelo base do Bedrockglobaluseujpapac
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0Copied!SimSimSimSimNão
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0Copied!SimSimSimNãoSim
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0Copied!NãoSimSimNãoSim
Claude Sonnet 3.5 anthropic.claude-3-5-sonnet-20241022-v2:0Copied!NãoSimNãoNãoSim
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0Copied!NãoSimNãoNãoNão
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0Copied!NãoSimNãoNãoNão
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0Copied!NãoSimNãoNãoNão
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0Copied!SimSimSimNãoNão
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0Copied!NãoSimNãoNãoNão
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0Copied!NãoSimSimNãoSim
Para mais informações sobre IDs de modelo regionais versus globais, consulte a seção Endpoints globais versus regionais abaixo.

Listar modelos disponíveis

Os exemplos a seguir mostram como imprimir uma lista de todos os modelos Claude disponíveis através do Bedrock:
aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Fazendo requisições

Os exemplos a seguir mostram como gerar texto a partir de Claude no Bedrock:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentique fornecendo as chaves abaixo ou use os provedores de credenciais AWS padrão, como
    # usando ~/.aws/credentials ou as variáveis de ambiente "AWS_SECRET_ACCESS_KEY" e "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Credenciais temporárias podem ser usadas com aws_session_token.
    # Leia mais em https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region muda a região aws para a qual a requisição é feita. Por padrão, lemos AWS_REGION,
    # e se isso não estiver presente, usamos como padrão us-east-1. Observe que não lemos ~/.aws/config para a região.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)
Consulte nossos SDKs de cliente para mais detalhes, e a documentação oficial do Bedrock aqui.

Registro de atividades

Bedrock fornece um serviço de registro de invocação que permite aos clientes registrar os prompts e conclusões associados ao seu uso. Anthropic recomenda que você registre sua atividade em pelo menos uma base móvel de 30 dias para entender sua atividade e investigar qualquer possível uso indevido.
Ativar este serviço não dá à AWS ou à Anthropic nenhum acesso ao seu conteúdo.

Suporte de recursos

Você pode encontrar todos os recursos atualmente suportados no Bedrock aqui.

Suporte a PDF no Bedrock

O suporte a PDF está disponível no Amazon Bedrock através da API Converse e da API InvokeModel. Para informações detalhadas sobre recursos e limitações de processamento de PDF, consulte a documentação de suporte a PDF. Considerações importantes para usuários da API Converse:
  • A análise visual de PDF (gráficos, imagens, layouts) requer que as citações sejam ativadas
  • Sem citações, apenas a extração básica de texto está disponível
  • Para controle total sem citações forçadas, use a API InvokeModel
Para mais detalhes sobre os dois modos de processamento de documentos e suas limitações, consulte o guia de suporte a PDF.

Janela de contexto de 1M de tokens

Claude Sonnet 4 e 4.5 suportam a janela de contexto de 1M de tokens no Amazon Bedrock.
A janela de contexto de 1M de tokens está atualmente em beta. Para usar a janela de contexto estendida, inclua o cabeçalho beta context-1m-2025-08-07 em suas requisições de API do Bedrock.

Endpoints globais versus regionais

A partir de Claude Sonnet 4.5 e todos os modelos futuros, Amazon Bedrock oferece dois tipos de endpoint:
  • Endpoints globais: Roteamento dinâmico para máxima disponibilidade
  • Endpoints regionais: Roteamento de dados garantido através de regiões geográficas específicas
Os endpoints regionais incluem um prêmio de preço de 10% sobre os endpoints globais.
Isso se aplica apenas a Claude Sonnet 4.5 e modelos futuros. Modelos mais antigos (Claude Sonnet 4, Opus 4 e anteriores) mantêm suas estruturas de preço existentes.

Quando usar cada opção

Endpoints globais (recomendado):
  • Fornecem máxima disponibilidade e tempo de atividade
  • Roteiam dinamicamente requisições para regiões com capacidade disponível
  • Sem prêmio de preço
  • Melhor para aplicações onde a residência de dados é flexível
Endpoints regionais (CRIS):
  • Roteiam tráfego através de regiões geográficas específicas
  • Necessários para requisitos de residência de dados e conformidade
  • Disponíveis para US, EU, Japão e Austrália
  • Prêmio de preço de 10% reflete custos de infraestrutura para capacidade regional dedicada

Implementação

Usando endpoints globais (padrão para Sonnet 4.5 e 4): Os IDs de modelo para Claude Sonnet 4.5 e 4 já incluem o prefixo global.:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
Usando endpoints regionais (CRIS): Para usar endpoints regionais, remova o prefixo global. do ID do modelo:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Usando endpoint regional US (CRIS)
message = client.messages.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",  # Sem prefixo global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Recursos adicionais