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 Configure o AWS CLI) ou encontre suas credenciais navegando para “Command line or programmatic access” dentro do seu painel AWS e seguindo as direçõ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 AWS Console > Bedrock > Model Access 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 altera 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": "Hello, world"}]
)
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 completions associados ao seu uso.

A Anthropic recomenda que você registre sua atividade em pelo menos 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.