Uso di una chiave API Amazon Bedrock - Amazon Bedrock

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

Uso di una chiave API Amazon Bedrock

La chiave API Amazon Bedrock può essere utilizzata nei modi indicati di seguito.

  • Impostata come variabile di ambiente: il servizio Amazon Bedrock riconosce la variabile di ambiente AWS_BEARER_TOKEN_BEDROCK. Per impostare la chiave sono disponibili le seguenti opzioni:

    • Apri un terminale:

      • MacOS/Linux

        export AWS_BEARER_TOKEN_BEDROCK=${api-key}

      • Windows

        setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

    • Imposta la chiave come variabile di ambiente nel codice prima di effettuare la richiesta API. Ad esempio, puoi includere le seguenti righe prima di effettuare la richiesta:

      • Python

        import os                      
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

  • Specificata in una richiesta: è possibile includere la chiave API Amazon Bedrock nell’intestazione di autorizzazione nei modi seguenti (sostituisci $AWS_BEARER_TOKEN_BEDROCK con il valore effettivo):

    • In una richiesta HTTP diretta: includi il codice seguente come intestazione dell’autorizzazione:

      Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

    • Come parametro in un SDK supportato: specifica il valore nel parametro durante la configurazione del client. Ad esempio, puoi specificare il valore nel campo api_key quando configuri un client con OpenAI Python SDK.

Nota

Le chiavi API Amazon Bedrock sono limitate alle azioni Amazon Bedrock e runtime di Amazon Bedrock. Non è possibile utilizzarle con le operazioni API seguenti:

Per esempio di utilizzo della chiave API per inviare una richiesta Converse per generare una risposta, scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:

Python

L’esempio seguente mostra come inviare una richiesta API con AWS SDK per Python (Boto3). Se non hai già impostato la chiave API come variabile di ambiente AWS_BEARER_TOKEN_BEDROCK, specificala al posto di ${api-key} nel codice seguente:

import os
import boto3
                        
# If you already set the API key as an environment variable, you can comment this line out                        
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create an Amazon Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1" # If you've configured a default region, you can omit this line
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello"}]}]

response = client.converse(
    modelId=model_id,
    messages=messages,
)
HTTP Client (requests package in Python)

Prerequisito: per installare il pacchetto requests, apri un terminale ed esegui questo comando:

python3 -m pip install requests

L’esempio seguente mostra come inviare direttamente una richiesta API con un client HTTP. Specifica ${api-key} nell’intestazione.

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

L’esempio seguente mostra come inviare direttamente una richiesta API con cURL. Se non hai impostato la chiave API come variabile di ambiente AWS_BEARER_TOKEN_BEDROCK, devi sostituire $AWS_BEARER_TOKEN_BEDROCK nell’esempio con il valore letterale della chiave.

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 $AWS_BEARER_TOKEN_BEDROCK" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'