Claude no Amazon Bedrock (legado)

Chamar o Claude através do Bedrock difere ligeiramente de como você chamaria o Claude diretamente na API do Claude. Este guia orienta você a completar uma chamada de API para o Claude no Bedrock usando um dos SDKs de cliente da Anthropic.

Observe que este guia pressupõe que você já se cadastrou em uma conta AWS e configurou o acesso programático.

Instalar e configurar a AWS CLI

1. Instale uma versão da AWS CLI igual ou mais recente que a versão 2.13.23
2. Configure suas credenciais da AWS usando o comando AWS configure (consulte Configurar a AWS CLI) ou encontre suas credenciais navegando até "Command line or programmatic access" no seu painel da AWS e seguindo as instruções no modal pop-up.
3. Verifique se suas credenciais estão funcionando:

aws sts get-caller-identity

Instalar um SDK para acessar o Bedrock

Os SDKs de cliente da Anthropic oferecem suporte ao Bedrock. Você também pode usar um SDK da AWS como o boto3 diretamente.

Acessando o Bedrock

Assinar os modelos da Anthropic

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

IDs de modelo da API

Os termos de ciclo de vida (Descontinuado, Retirado) são definidos em Descontinuações de modelos. As datas de ciclo de vida em plataformas operadas por parceiros são definidas pelo parceiro e podem diferir do cronograma da API do Claude. Para a data atual de retirada de qualquer modelo no Amazon Bedrock, consulte a página de ciclo de vida de modelos do Amazon Bedrock.

Para mais informações sobre IDs de modelo regionais vs globais, consulte a seção Endpoints globais vs regionais.

Listar modelos disponíveis

Os exemplos a seguir mostram como imprimir uma lista de todos os modelos Claude disponíveis através do Bedrock:

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])

Fazendo requisições

Os exemplos a seguir mostram como gerar texto a partir do Claude no Bedrock:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentique-se fornecendo as chaves abaixo ou use os provedores de credenciais padrão da AWS, como
    # o arquivo ~/.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 altera a região da AWS para a qual a requisição é feita. Por padrão, o SDK lê AWS_REGION,
    # e, se não estiver presente, usa us-east-1 como padrão. Observe que o SDK não lê ~/.aws/config para a região.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

Consulte os SDKs de cliente para mais detalhes, e a documentação oficial do Bedrock.

Autenticação por bearer token

Você pode autenticar com o Bedrock usando bearer tokens em vez de credenciais da AWS. Isso é útil em ambientes corporativos onde as equipes precisam de acesso ao Bedrock sem gerenciar credenciais da AWS, funções IAM ou permissões em nível de conta.

A abordagem mais simples é definir a variável de ambiente AWS_BEARER_TOKEN_BEDROCK, que cada SDK detecta automaticamente ao resolver credenciais do ambiente.

Para fornecer um token programaticamente:

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-west-2",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

Registro de atividades

O Bedrock fornece um serviço de registro de invocações que permite aos clientes registrar os prompts e completions associados ao seu uso.

A Anthropic recomenda que você registre sua atividade em uma base contínua de pelo menos 30 dias para entender sua atividade e investigar qualquer possível uso indevido.

Suporte a recursos

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

Destaques de recursos suportados

• Messages API
• Cache de prompt
• Pensamento estendido
• Uso de ferramentas, incluindo a ferramenta Bash, ferramenta de uso de computador, ferramenta de memória e 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, web fetch, 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)

Suporte a PDF no Bedrock

O suporte a PDF está disponível no Bedrock através da Converse API e da InvokeModel API. Para informações detalhadas sobre capacidades e limitações de processamento de PDF, consulte Suporte a PDF no Amazon Bedrock.

Considerações importantes para usuários da Converse API:

• A análise visual de PDF (gráficos, imagens, layouts) requer que as citações estejam habilitadas
• Sem citações, apenas a extração básica de texto está disponível
• Para controle total sem citações forçadas, use a InvokeModel API

Janela de contexto

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 e Claude Sonnet 4.6 têm uma janela de contexto de 1M de tokens no Amazon Bedrock. Outros modelos Claude, incluindo Sonnet 4.5 e Sonnet 4 (descontinuado), têm uma janela de contexto de 200k tokens.

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

Endpoints globais vs regionais

A partir do Claude Sonnet 4.5 e todos os modelos futuros, o 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 acréscimo de 10% no preço em relação aos endpoints globais.

Quando usar cada opção

Endpoints globais (recomendado):

• Fornecem máxima disponibilidade e tempo de atividade
• Roteiam dinamicamente as requisições para regiões com capacidade disponível
• Sem acréscimo de preço
• Melhor para aplicações onde a residência de dados é flexível

Endpoints regionais (CRIS):

• Roteiam o 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 EUA, UE, Japão e Ásia-Pacífico
• O acréscimo de 10% no preço reflete os custos de infraestrutura para capacidade regional dedicada

Implementação

Usando endpoints globais (padrão para Opus 4.6, Sonnet 4.6 e Sonnet 4.5):

Os IDs de modelo para Claude Opus 4.6, Sonnet 4.6 e Sonnet 4.5 já incluem o prefixo global.:

from anthropic import AnthropicBedrock

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

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Usando endpoints regionais (CRIS):

Para usar endpoints regionais, substitua o prefixo global. por um prefixo regional como us.:

from anthropic import AnthropicBedrock

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

# Usando endpoint regional dos EUA (CRIS)
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Recursos adicionais

• Preços do Bedrock: aws.amazon.com/bedrock/pricing
• Documentação de preços da AWS: Guia de preços do Bedrock
• Post no blog da AWS: Apresentando o Claude Sonnet 4.5 no Amazon Bedrock
• Detalhes de preços da Anthropic: Preços de plataformas de nuvem