Chamar o Claude através do Bedrock difere ligeiramente de como você chamaria o Claude ao usar os SDKs de cliente da Anthropic. Este guia irá orientá-lo através do processo de completar uma chamada de API para o Claude no Bedrock em Python ou TypeScript.

Note que este guia assume que você já se inscreveu para uma conta AWS e configurou o acesso programático.

Instalar e configurar o AWS CLI

  1. Instale uma versão do AWS CLI na versão 2.13.23 ou mais recente
  2. Configure suas credenciais AWS usando o comando AWS configure (veja Configurar o AWS CLI) ou encontre suas credenciais navegando para “Acesso por linha de comando ou programático” dentro do seu painel AWS e seguindo as instruções no modal popup.
  3. 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.

pip install -U "anthropic[bedrock]"

Acessando o Bedrock

Inscrever-se nos modelos Anthropic

Vá para o Console AWS > Bedrock > Acesso ao Modelo e solicite acesso aos modelos Anthropic. Note que a disponibilidade dos modelos Anthropic varia por região. Veja a documentação AWS para informações mais recentes.

Nomes dos modelos da API

ModeloNome do modelo da API Bedrock
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0
Claude Sonnet 3.5anthropic.claude-3-5-sonnet-20241022-v2:0
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3 anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

Listar modelos disponíveis

Os seguintes exemplos 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 solicitações

Os seguintes exemplos mostram como gerar texto 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
    # usar ~/.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 us-east-1 como padrão. Note que não lemos ~/.aws/config para a região.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="anthropic.claude-opus-4-20250514-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Olá, mundo"}]
)
print(message.content)

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

Registro de atividade

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 pelo menos em uma base rotativa de 30 dias para entender sua atividade e investigar qualquer possível uso indevido.

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

Suporte a 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 tanto da API Converse quanto 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 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 API InvokeModel

Para mais detalhes sobre os dois modos de processamento de documentos e suas limitações, consulte o guia de suporte a PDF.