使用 Amazon Bedrock API 密钥

您可以通过以下方式使用您的 Amazon Bedrock API 密钥：

• 将其设置为环境变量 — Amazon Bedrock 服务可识别环境变量AWS_BEARER_TOKEN_BEDROCK您可以通过以下选项来设置密钥：

  • 打开终端进行设置：

    • macOS/Linux

      export AWS_BEARER_TOKEN_BEDROCK=${api-key}

    • Windows

      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

  • 在发出 API 请求之前，将其设置为代码中的环境变量。例如，您可以在发出请求之前加入以下几行：

    • Python

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

• 在@@ 请求中指定 — 您可以通过以下方式将 Amazon Bedrock API 密钥包含在授权标题中（$AWS_BEARER_TOKEN_BEDROCK替换为实际值）：

  • 在直接 HTTP 请求中 — 包括以下内容作为授权标头：

    Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

  • 作为支持的 SDK 中的参数-在设置客户端时指定参数中的值。例如，在使用 OpenAIPython SDK 设置客户端时，可以在api_key字段中指定它。

注意

亚马逊 Bedrock API 密钥仅限于亚马逊 B edrock 和亚马逊 Bedroc k 运行时操作。您不能将它们用于以下 API 操作：

• InvokeModelWithBidirectionalStream.

• 亚马逊 Bedrock 的代理或亚马逊 Bedrock 运行时 API 操作的代理。

• 亚马逊 Bedro@@ ck 的数据自动化或亚马逊 Bedrock 数据自动化 API 操作的 Runtime。

要查看使用 API 密钥发送 Converse 请求以生成响应的示例，请选择首选方法的选项卡，然后按照以下步骤操作：

Python

以下示例说明如何使用发送 API 请求 适用于 Python (Boto3) 的 AWS SDK。如果您尚未将 API 密钥设置为AWS_BEARER_TOKEN_BEDROCK环境变量，请在以下代码${api-key}中将其替换为：

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)

先决条件：通过打开终端并运行以下命令来安装requests软件包：

python3 -m pip install requests

以下示例说明如何使用 HTTP 客户端直接发送 API 请求。在标题${api-key}中指定。

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 直接发送 API 请求。如果您没有将 API 密钥设置为 AWS_BEARER_TOKEN_BEDROCK 环境变量，则必须将示例$AWS_BEARER_TOKEN_BEDROCK中的密钥替换为密钥的字面值。

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