Comece a usar as chaves de API do Amazon Bedrock: gere uma chave de trinta dias e faça sua primeira chamada de API - Amazon Bedrock

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

Comece a usar as chaves de API do Amazon Bedrock: gere uma chave de trinta dias e faça sua primeira chamada de API

Este tutorial explica como criar uma chave de API de longo prazo do Amazon Bedrock que expira em 30 dias e como usá-la para fazer uma simples chamada de API Converse usando Python. Essa é a maneira mais rápida de começar a experimentar o Amazon Bedrock sem configurar credenciais complexas AWS .

Atenção

As chaves de API de longo prazo são recomendadas somente para exploração e desenvolvimento do Amazon Bedrock. Para aplicações de produção, use alternativas às chaves de acesso de longo prazo, como perfis do IAM ou credenciais temporárias.

Siga estas etapas para criar uma chave de API de longo prazo do Amazon Bedrock que expira em trinta dias:

  1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em https://console.aws.amazon.com/bedrock.

  2. No painel de navegação à esquerda, selecione Chaves de API.

  3. Na guia Chaves de API de longo prazo, escolha Gerar chaves de API de longo prazo.

  4. Na seção Expiração da chave de API, selecione 30 dias.

  5. Escolha Gerar. A chave que você gera fornece permissões para realizar as principais ações do Amazon Bedrock, conforme definido na AmazonBedrockLimitedAccesspolítica em anexo.

  6. Copie a chave de API gerada e armazene-a com segurança. Você precisará dessa chave na próxima etapa.

    Importante

    A chave de API só é exibida uma vez. Copie e salve-a antes de fechar a caixa de diálogo. Lembre-se de que a chave de API expirará em trinta dias. Você pode gerar outra seguindo as mesmas etapas ou considerar a possibilidade mudar para métodos de autenticação mais seguros para uso contínuo.

  7. Defina a chave de API como uma variável de ambiente ${api-key} substituindo-a pelo valor da chave de API gerada e use-a para gerar uma resposta no método de sua escolha:

    Python
    import boto3
import os

# Set the API key as an environment variable
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create the Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1"
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello! Can you tell me about Amazon Bedrock?"}]}]

# Make the API call
response = client.converse(
    modelId=model_id,
    messages=messages,
)

# Print the response
print(response['output']['message']['content'][0]['text'])
    HTTP client using Python
    import requests

url = "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse"

payload = {
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ${api-key}"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
    HTTP request using cURL
    curl -X POST "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${api-key}" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'

Parabéns! Você gerou com sucesso uma chave de API do Amazon Bedrock e fez sua primeira chamada de API para o serviço Amazon Bedrock. Depois de explorar mais algumas ações do Amazon Bedrock, você deve fazer a transição para métodos mais seguros de autenticação, como chaves de API do Amazon Bedrock de curto prazo ou credenciais temporárias AWS abrangentes. Consulte os seguintes recursos para saber mais:

  • Explore modelos diferentes: conheça outros modelos de base disponíveis no Amazon Bedrock em Informações sobre modelos de base do Amazon Bedrock e altere o model_id em seu código para testá-los.

  • Saiba o que é inferência do modelo: para saber como gerar respostas com inferência do modelo, leia o texto Envie prompts e gere respostas com a inferência de modelo, que aborda os conceitos e opções disponíveis no Amazon Bedrock.

  • Planeje a produção com métodos de autenticação mais seguros — Leia sobre as chaves de API do Amazon Bedrock com mais detalhes no capítulo Build e como criar chaves de API do Amazon Bedrock mais seguras e de curto prazo. Quando estiver pronto para criar aplicativos de produção, você também deve analisar alternativas às chaves de acesso de longo prazo para obter opções mais seguras que também permitam o acesso a outros AWS serviços.