View a markdown version of this page

Inferência usando a API de mensagens antrópicas - Amazon Bedrock
Regiões aceitasPré-requisitosSolicitação básicaTransmita respostasRecursos compatíveisContar fichas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Inferência usando a API de mensagens antrópicas

A API Anthropic Messages fornece acesso nativo aos modelos Claude usando o formato de solicitação e resposta do Anthropic. Você pode usar a API de mensagens nos bedrock-runtime terminais bedrock-mantle e nos terminais, oferecendo flexibilidade para escolher o estilo de autenticação e integração adequado ao seu aplicativo.

Endpoint URL base Caso de uso
bedrock-mantle https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages Recomendado para novas aplicações. Suporta autenticação de chave de API e. Espaços de trabalho () Anthropic-compatible
bedrock-runtime https://bedrock-runtime.{region}.amazonaws.com Use com integrações de AWS SDK e registro de invocações existentes.

Regiões aceitas

A API de mensagens está disponível no bedrock-mantle endpoint em todas as regiões compatíveis bedrock-mantle (consulteRegiões e endpoints compatíveis). No bedrock-runtime endpoint, ele está disponível em todas as regiões em que os modelos Claude estão disponíveis. Para mais detalhes, consulte Disponibilidade regional por modelos.

Pré-requisitos

Antes de usar a API de mensagens, verifique se você tem o seguinte:

  • Acesso ao modelo — Solicite acesso aos modelos Claude no console Amazon Bedrock. Consulte Solicitar acesso aos modelos.

  • Autenticação — Depende do endpoint:

    • bedrock-mantle— Use uma chave de API Amazon Bedrock (consulteChaves de API) ou credenciais AWS SigV4.

    • bedrock-runtime— Use as credenciais AWS SigV4 por meio do AWS SDK (boto3, etc.).

  • Cabeçalho da versão antrópica — Todas as solicitações exigem uma versão de API:

    • bedrock-mantle: definido anthropic-version: 2023-06-01 como um cabeçalho HTTP.

    • bedrock-runtime: definido "anthropic_version": "bedrock-2023-05-31" no corpo da solicitação.

Solicitação básica

Para enviar uma mensagem básica para um modelo Claude, escolha a guia do seu método preferido e siga as etapas:

bedrock-mantle (curl)
curl -X POST https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  -H "x-api-key: $BEDROCK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic.claude-sonnet-4-6-v1",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Explain quantum computing in one sentence."}
    ]
  }'
bedrock-runtime (Python)
import boto3
import json

client = boto3.client("bedrock-runtime", region_name="us-east-1")

response = client.invoke_model(
    modelId="anthropic.claude-sonnet-4-6-v1",
    body=json.dumps({
        "anthropic_version": "bedrock-2023-05-31",
        "max_tokens": 1024,
        "messages": [
            {"role": "user", "content": "Explain quantum computing in one sentence."}
        ]
    })
)

result = json.loads(response["body"].read())
print(result["content"][0]["text"])
bedrock-runtime (AWS CLI)

Use a AWS CLI para invocar o modelo:

aws bedrock-runtime invoke-model \
  --model-id anthropic.claude-sonnet-4-6-v1 \
  --body '{
    "anthropic_version": "bedrock-2023-05-31",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Explain quantum computing in one sentence."}
    ]
  }' \
  --cli-binary-format raw-in-base64-out \
  output.json
bedrock-runtime (curl)

Você pode ligar bedrock-runtime diretamente com curl assinando a solicitação com AWS SigV4. O exemplo abaixo usa o --aws-sigv4 sinalizador embutido do curl (disponível no curl 7.75.0 e versões posteriores):

curl -X POST \
  "https://bedrock-runtime.us-east-1.amazonaws.com/model/anthropic.claude-sonnet-4-6-v1/invoke" \
  -H "Content-Type: application/json" \
  --aws-sigv4 "aws:amz:us-east-1:bedrock" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -d '{
    "anthropic_version": "bedrock-2023-05-31",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Explain quantum computing in one sentence."}
    ]
  }'
nota

Se você estiver usando credenciais temporárias do AWS STS (por exemplo, uma função assumida), passe também o token da sessão adicionando -H "X-Amz-Security-Token: $AWS_SESSION_TOKEN" à solicitação. Para a maioria dos casos de uso, recomendamos os AWS SDKs ou a CLI, que processam a assinatura de solicitações e a atualização de credenciais automaticamente.

Transmita respostas

Para receber tokens de resposta incrementalmente à medida que são gerados, escolha a guia do seu método preferido e siga as etapas:

bedrock-mantle (curl)
curl -X POST https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  -H "x-api-key: $BEDROCK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic.claude-sonnet-4-6-v1",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
        {"role": "user", "content": "Write a short poem about cloud computing."}
    ]
  }'
bedrock-runtime (Python)
import boto3
import json

client = boto3.client("bedrock-runtime", region_name="us-east-1")

response = client.invoke_model_with_response_stream(
    modelId="anthropic.claude-sonnet-4-6-v1",
    body=json.dumps({
        "anthropic_version": "bedrock-2023-05-31",
        "max_tokens": 1024,
        "messages": [
            {"role": "user", "content": "Write a short poem about cloud computing."}
        ]
    })
)

for event in response["body"]:
    chunk = json.loads(event["chunk"]["bytes"])
    if chunk["type"] == "content_block_delta":
        print(chunk["delta"]["text"], end="")

Recursos compatíveis

Além das seções Pensamento estendido, Pensamento adaptativo, Saídas estruturadas, Compactação, Crédito alternativo para solicitações recusadas (beta) e mensagens Mid-conversation do sistema acima, a API de mensagens oferece suporte aos seguintes recursos com os modelos Claude:

  • Solicitações do sistema — Defina o comportamento do modelo com um system parâmetro.

  • Multi-turn conversas — Passe alternância user e assistant mensagens.

  • Uso da ferramenta — Defina as ferramentas que o modelo pode chamar. Consulte Use uma ferramenta para concluir uma resposta do modelo do Amazon Bedrock.

  • Visão — Envie imagens na content matriz junto com o texto.

  • Cache imediato — Armazene em cache o contexto usado com frequência para reduzir a latência e o custo.

Para ver a referência completa do campo de solicitação e resposta da API de mensagens, consulteSolicitação e reposta.

Contar fichas

Para contar o número de tokens de entrada que uma solicitação consumiria antes de enviá-la para inferência, use o count_tokens caminho antrópico no bedrock-mantle endpoint. Esse é o único caminho de contagem de tokens compatível com modelos Claude que não estão disponíveis em um Region-specific endpoint, incluindo modelos Claude que são iniciados somente bedrock-runtime com inferência entre regiões (CRIS). Para obter detalhes e um exemplo, consulte Conte os tokens usando o ponto final Bedrock-mantle.