Claude no Amazon Bedrock

Chamar Claude através do Bedrock difere ligeiramente de como você chamaria Claude ao usar os SDKs do 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

Instale uma versão da AWS CLI na versão 2.13.23 ou mais recente
Configure suas credenciais AWS usando o comando AWS configure (veja 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.
Verifique se suas credenciais estão funcionando:

Shell

aws sts get-caller-identity

Instalar um SDK para acessar Bedrock

Os SDKs do 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. Veja documentação AWS para informações mais recentes.

IDs de modelo de API

Modelo	ID do modelo Bedrock base	`global`	`us`	`eu`	`jp`	`apac`
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Sim	Sim	Sim	Sim	Não
Claude Sonnet 4	anthropic.claude-sonnet-4-20250514-v1:0	Sim	Sim	Sim	Não	Sim
Claude Sonnet 3.7 ⚠️	anthropic.claude-3-7-sonnet-20250219-v1:0

Para mais informações sobre IDs de modelo regional vs global, veja a seção Global vs regional endpoints 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:

Veja nossos SDKs do 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 capacidades e limitações de processamento de PDF, veja 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 da API Bedrock.

Global vs regional endpoints

Começando com 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

Endpoints regionais incluem um prêmio de preço de 10% sobre 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.:

Usando endpoints regionais (CRIS):

Para usar endpoints regionais, remova o prefixo global. do ID do modelo:

Recursos adicionais

Preço do AWS Bedrock: aws.amazon.com/bedrock/pricing
Documentação de preço da AWS: Guia de preço do Bedrock
Postagem do blog AWS: Introducing Claude Sonnet 4.5 in Amazon Bedrock
Detalhes de preço da Anthropic: Documentação de preço

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 solicitaçã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)

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"}]
)

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"}]
)