Claude no Amazon Bedrock

Amazon Bedrock (legado)

Esta página cobre a integração do Amazon Bedrock disponível hoje (as APIs InvokeModel e Converse com identificadores de modelo com versão ARN e codificação de fluxo de eventos AWS). Uma visualização de pesquisa de uma nova oferta gerenciada pela AWS, com a API Messages em /anthropic/v1/messages e streaming SSE, está documentada em Claude no Amazon Bedrock (visualização de pesquisa).

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

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

Claude Opus 4.7 está disponível na AWS através de Claude no Amazon Bedrock, atualmente em visualização de pesquisa. Não está disponível através do catálogo de modelos Bedrock padrão documentado nesta página.

Modelo	ID de modelo Bedrock base	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1	Sim	Sim	Sim	Sim	Sim
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Sim	Sim	Sim	Sim	Não
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Sim

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:

Fazendo requisições

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

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 autenticação com token portador é suportada nos SDKs C#, Go e Java. Os SDKs PHP, Python, TypeScript e Ruby usam apenas assinatura AWS SigV4.

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:

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.

Ativar este serviço não dá à AWS ou à Anthropic nenhum acesso ao seu conteúdo.

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.

Isso se aplica apenas a Claude Sonnet 4.5 e modelos futuros. Modelos mais antigos (Claude Sonnet 4 (descontinuado), Opus 4 (descontinuado) 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 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.:

Usando endpoints regionais (CRIS):

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

Claude Mythos Preview é um modelo de visualização de pesquisa disponível para clientes convidados no Amazon Bedrock. Para mais informações, veja Project Glasswing.

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

import boto3

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

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

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)

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

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

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