Claude no Amazon Bedrock

Chamar Claude através do Bedrock é ligeiramente diferente de como você chamaria Claude ao usar os SDKs de cliente da Anthropic. Este guia o orienta na conclusão de uma chamada de API para Claude no Bedrock usando um dos SDKs de cliente da Anthropic.

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 (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.
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 suportam Bedrock. Você também pode usar um SDK AWS como boto3 diretamente.

Acessando o 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

Para mais informações sobre IDs de modelo regionais versus globais, veja 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:

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 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, padronizamos para 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-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

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

Autenticação com token portador

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

A abordagem mais simples é definir a variável de ambiente AWS_BEARER_TOKEN_BEDROCK, que é detectada automaticamente pela resolução de credenciais fromEnv().

Para fornecer um token programaticamente:

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

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

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ção que permite aos clientes registrar os prompts e conclusões associados ao seu uso.

A 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.

Suporte a recursos

Para todos os recursos atualmente suportados no Bedrock, veja visão geral dos recursos da API.

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, 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

Claude Opus 4.6 e Claude Sonnet 4.6 têm uma janela de contexto de 1M 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 Amazon Bedrock limita cargas úteis de solicitação a 20 MB. Ao enviar documentos grandes ou muitas imagens, você pode atingir este limite antes do limite de tokens.

Endpoints globais versus regionais

A partir de Claude Sonnet 4.5 e todos os modelos futuros, o 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.

Quando usar cada opção

Endpoints globais (recomendado):

• Fornecem máxima disponibilidade e tempo de atividade
• Roteiam dinamicamente solicitaçõ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 Opus 4.6, Sonnet 4.5 e Sonnet 4 (descontinuado)):

Os IDs de modelo para Claude Sonnet 4.5 e 4 (descontinuado) 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, remova o prefixo global. do ID do modelo:

from anthropic import AnthropicBedrock

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

# Using US regional endpoint (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # No global. prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Recursos adicionais

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