Verwenden eines API-Schlüssels von Amazon Bedrock - Amazon Bedrock

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden eines API-Schlüssels von Amazon Bedrock

Sie können Ihren API-Schlüssel von Amazon Bedrock auf folgende Weise verwenden:

  • Als Umgebungsvariable festlegen – Der Amazon-Bedrock-Service erkennt die Umgebungsvariable AWS_BEARER_TOKEN_BEDROCK. Sie haben folgenden Optionen, um den Schlüssel festzulegen:

    • Öffnen Sie zum Festlegen ein Terminal:

      • macOS/Linux

        export AWS_BEARER_TOKEN_BEDROCK=${api-key}

      • Windows

        setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

    • Legen Sie ihn vor der dem Tätigen der API-Anfrage als Umgebungsvariable in Ihrem Code fest. Sie können beispielsweise die folgenden Zeilen hinzufügen, bevor Sie die Anforderung senden.

      • Python

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

  • In einer Anforderung angeben – Sie können den API-Schlüssel von Amazon Bedrock wie folgt in den Autorisierungs-Header aufnehmen (ersetzen Sie $AWS_BEARER_TOKEN_BEDROCK durch den tatsächlichen Wert):

    • In einer direkten HTTP-Anfrage – Fügen Sie Folgendes als Autorisierungs-Header ein:

      Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

    • Als Parameter in einem unterstützten SDK – Geben Sie den Wert im Parameter an, wenn Sie den Client einrichten. Sie können ihn beispielsweise im api_key-Feld angeben, wenn Sie einen Client mit dem OpenAI-Python SDK einrichten.

Anmerkung

API-Schlüssel von Amazon Bedrock sind auf Aktionen von Amazon Bedrock und Amazon Bedrock Runtime beschränkt. Sie können sie mit folgenden API-Operationen nicht verwenden:

Um ein Beispiel für die Verwendung des API-Schlüssels zum Senden einer Converse-Anfrage zum Generieren einer Antwort zu senden, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen die Schritte:

Python

Das folgende Beispiel zeigt, wie Sie eine API-Anfrage mit dem AWS SDK für Python (Boto3) senden. Wenn Sie den API-Schlüssel noch nicht als AWS_BEARER_TOKEN_BEDROCK-Umgebungsvariable festgelegt haben, geben Sie ihn im folgenden Code anstelle von ${api-key} an:

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)

Voraussetzung: Installieren Sie das requests-Paket, indem Sie ein Terminal öffnen und den folgenden Befehl ausführen:

python3 -m pip install requests

Das folgende Beispiel zeigt, wie Sie eine API-Anfrage direkt über einen HTTP-Client senden. Geben Sie den ${api-key} im Header an.

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

Das folgende Beispiel zeigt, wie Sie eine API-Anfrage direkt mittels cURL senden. Wenn Sie den API-Schlüssel nicht als AWS_BEARER_TOKEN_BEDROCK-Umgebungsvariable festgelegt haben, müssen Sie $AWS_BEARER_TOKEN_BEDROCK im Beispiel durch den Literalwert des Schlüssels ersetzen.

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