Comece a usar as chaves de API do Amazon Bedrock: gere uma chave de 30 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 30 dias e faça sua primeira chamada de API

Este tutorial explica como criar uma chave de API Amazon Bedrock de longo prazo que expira em 30 dias e como usá-la para fazer uma simples chamada à 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 aplicativos de produção, use alternativas às chaves de acesso de longo prazo, como funções do IAM ou credenciais temporárias.

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

  1. Faça login no AWS Management Console 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 esquerdo, 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 para a próxima etapa.

    Importante

    A chave da API só é exibida uma vez. Certifique-se de copiá-lo e salvá-lo antes de fechar a caixa de diálogo. Lembre-se de que sua chave de API expirará em 30 dias. Você pode gerar um novo seguindo as mesmas etapas ou considerar a transição 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: