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フィールドで指定できます。

注記

Amazon Bedrock API キーは、Amazon Bedrock および Amazon Bedrock ランタイムアクションに限定されます。次の API オペレーションでは使用できません。

• InvokeModelWithBidirectionalStream。

• Agents for Amazon Bedrock または Agents for Amazon Bedrock ランタイム API オペレーション。

• Amazon Bedrock のデータ自動化または Amazon Bedrock データ自動化 API オペレーションのランタイム。

API キーを使用して Converse リクエストを送信してレスポンスを生成する例を確認するには、任意の方法のタブを選択し、ステップに従います。

Python

次の例は、 を使用して API リクエストを送信する方法を示しています AWS SDK for Python (Boto3)。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"}]
        }
    ]
  }'