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

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 da 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 do Amazon Bedrock. Em seguida, abra o console do 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 política anexada AmazonBedrockLimitedAccess.

  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 substituindo ${api-key} pelo valor da chave de API gerada e use-a para gerar uma resposta no método de sua preferência:

    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 abrangentes da AWS. Consulte os seguintes recursos para saber mais: