Usa una chiave API Amazon Bedrock

Puoi utilizzare la tua chiave API Amazon Bedrock nei seguenti modi:

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

  • Apri un terminale per impostarlo:

    • macOS/Linux

      export AWS_BEARER_TOKEN_BEDROCK=${api-key}

    • Windows

      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

  • Impostala 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}"

• Specificalo in una richiesta: puoi includere la chiave API Amazon Bedrock nell'intestazione di autorizzazione nei seguenti modi (sostituiscila $AWS_BEARER_TOKEN_BEDROCK con il valore effettivo):

  • In una richiesta HTTP diretta: includi quanto segue come intestazione di 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 specificarlo nel api_key campo quando configuri un client con OpenAIPython SDK.

Nota

Le chiavi API di Amazon Bedrock sono limitate alle azioni Amazon Bedrock e Amazon Bedrock Runtime. Non puoi utilizzarle con le seguenti operazioni API:

• InvokeModelWithBidirectionalStream.

• Agenti per le operazioni dell'API Amazon Bedrock o Agents for Amazon Bedrock Runtime.

• Data Automation per Amazon Bedrock o Runtime per le operazioni dell'API Amazon Bedrock Data Automation.

Per vedere un esempio di utilizzo della chiave API per inviare una richiesta Converse per generare una risposta, scegli la scheda corrispondente al metodo che preferisci, quindi segui i passaggi:

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 AWS_BEARER_TOKEN_BEDROCK ambiente, specificala al ${api-key} posto del 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: installa il requests pacchetto aprendo un terminale ed eseguendo il seguente comando:

python3 -m pip install requests

L'esempio seguente mostra come inviare direttamente una richiesta API con un client HTTP. Specificare il ${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, utilizzando cURL. Se non hai impostato la chiave API come variabile di AWS_BEARER_TOKEN_BEDROCK ambiente, dovrai sostituirla $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"}]
        }
    ]
  }'