

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
<a name="getting-started-api-keys"></a>

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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys), 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.](https://console.aws.amazon.com/bedrock)

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

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

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

1. Escolha **Gerar**. A chave que você gera fornece permissões para realizar as principais ações do Amazon Bedrock, conforme definido na [AmazonBedrockLimitedAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockLimitedAccess)política em anexo.

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

1. Defina a chave de API como uma variável de ambiente *\$1\$1api-key\$1* 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\$1 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](foundation-models-reference.md) 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](inference.md), 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) para obter opções mais seguras que também permitam o acesso a outros AWS serviços.