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

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 *\$1AWS\$1BEARER\$1TOKEN\$1BEDROCK* 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](https://github.com/openai/openai-python?tab=readme-ov-file#usage) einrichten.

**Anmerkung**  
API-Schlüssel von Amazon Bedrock sind auf Aktionen von [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) und [Amazon Bedrock Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) beschränkt. Sie können sie mit folgenden API-Operationen nicht verwenden:  
[InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html)
API-Operationen vom Typ [Agenten für Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) oder [Agenten für Amazon Bedrock Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html).
API-Operationen vom Typ [Datenautomatisierung für Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Data_Automation_for_Amazon_Bedrock.html) oder [Laufzeit für Amazon Bedrock Data Automation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Runtime_for_Amazon_Bedrock_Data_Automation)

Um ein Beispiel für die Verwendung des API-Schlüssels zum Senden einer [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)-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 *\$1\$1api-key\$1* 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 *\$1\$1api-key\$1* 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\$1BEARER\$1TOKEN\$1BEDROCK-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"}]
        }
    ]
  }'
```

------