Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Nozioni di base sulle chiavi API di Amazon Bedrock: generazione di una chiave di 30 giorni ed esecuzione della prima chiamata API
<a name="getting-started-api-keys"></a>

In questo tutorial viene illustrato come creare una chiave API Amazon Bedrock a lungo termine con scadenza a 30 giorni e come utilizzarla per effettuare una semplice chiamata API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) utilizzando Python. Questo è il modo più veloce per iniziare a sperimentare con Amazon Bedrock senza impostare credenziali complesse AWS .

**avvertimento**  
Le chiavi API a lungo termine sono consigliate solo per l’esplorazione e lo sviluppo di Amazon Bedrock. Per le applicazioni di produzione, utilizza [alternative alle chiavi di accesso a lungo termine](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys), come i ruoli IAM o le credenziali temporanee.

Segui questi passaggi per creare una chiave API Amazon Bedrock a lungo termine con scadenza a 30 giorni:

1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)

1. Nel riquadro di navigazione a sinistra, seleziona **Chiavi API**.

1. Nella scheda **Chiavi API a lungo termine**, scegli **Genera chiavi API a lungo termine**.

1. Nella sezione **Scadenza della chiave API**, seleziona **30 giorni**.

1. Scegliere **Generate (Genera)**. La chiave generata fornisce le autorizzazioni per eseguire le azioni principali di Amazon Bedrock, come definito nella policy allegata [AmazonBedrockLimitedAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockLimitedAccess).

1. Copia la chiave API generata e archiviala in modo sicuro. Tale chiave servirà nella fase successiva.
**Importante**  
La chiave API viene visualizzata solo una volta. Assicurati di copiarla e salvarla prima di chiudere la finestra di dialogo. Ricorda che la chiave API scadrà tra 30 giorni. Per generarne una nuova, segui le stesse fasi o valuta il passaggio a metodi di autenticazione più sicuri per l’uso continuativo.

1. Imposta la chiave API come variabile di ambiente sostituendola {{${api-key}}} con il valore della chiave API generata e usala per generare una risposta con il metodo che preferisci:

------
#### [ 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"}]
           }
       ]
     }'
   ```

------

Complimenti\! Hai generato con successo una chiave API Amazon Bedrock ed effettuato la prima chiamata API al servizio Amazon Bedrock. Dopo aver esplorato altre azioni di Amazon Bedrock, dovresti passare a metodi di autenticazione più sicuri, come chiavi API Amazon Bedrock a breve termine o credenziali temporanee a AWS livello globale. Per ulteriori informazioni, consulta le seguenti risorse:
+ **Esplora diversi modelli**: scopri altri modelli di fondazione disponibili in Amazon Bedrock in [Utilizzo di modelli con Bedrock](foundation-models-reference.md) e modifica `model_id` nel codice per provarli.
+ **Scopri l’inferenza del modello**: scopri come generare risposte con l’inferenza del modello leggendo i concetti e le opzioni disponibili in Amazon Bedrock in [Invio di prompt e generazione di risposte con l’inferenza del modello](inference.md).
+ **Pianifica la produzione con metodi di autenticazione più sicuri**: scopri maggiori dettagli sulle chiavi API Amazon Bedrock nel capitolo Build e su come creare chiavi API Amazon Bedrock più sicure e a breve termine. Quando sei pronto a creare applicazioni di produzione, dovresti anche esaminare le [alternative alle chiavi di accesso a lungo termine](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) per trovare opzioni più sicure che consentano anche l'accesso ad altri AWS servizi.