使用 Amazon Bedrock API 密钥 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon Bedrock API 密钥

要使用您的 API 密钥，您必须在调用 API AWS_BEARER_TOKEN_BEDROCK 之前将其设置为名为的环境变量。您可以通过以下选项来设置密钥：

  • 打开终端进行设置：

    • macOS/Linux

      export AWS_BEARER_TOKEN_BEDROCK=${api-key}

    • Windows

      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

  • 在发出 API 请求之前，将其设置为代码中的环境变量。

注意

Amazon Bedrock API 密钥不能与一起使用。InvokeModelWithBidirectionalStream

要查看使用 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"}]
        }
    ]
  }'