Menggunakan kunci Amazon Bedrock API

Anda dapat menggunakan kunci Amazon Bedrock API dengan cara berikut:

• Tetapkan sebagai variabel lingkungan - Layanan Amazon Bedrock mengenali variabel lingkungan AWS_BEARER_TOKEN_BEDROCK Anda memiliki opsi berikut untuk menyetel kunci:

  • Buka terminal untuk mengaturnya:

    • MacOS/Linux

      export AWS_BEARER_TOKEN_BEDROCK=${api-key}

    • Windows

      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

  • Tetapkan sebagai variabel lingkungan dalam kode Anda sebelum Anda membuat permintaan API. Misalnya, Anda dapat menyertakan baris berikut sebelum membuat permintaan:

    • Python

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

• Tentukan dalam permintaan — Anda dapat menyertakan kunci Amazon Bedrock API di header otorisasi dengan cara berikut (ganti $AWS_BEARER_TOKEN_BEDROCK dengan nilai sebenarnya):

  • Dalam permintaan HTTP langsung - Sertakan yang berikut ini sebagai header otorisasi:

    Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

  • Sebagai parameter dalam SDK yang didukung — Tentukan nilai dalam parameter saat menyiapkan klien. Misalnya, Anda dapat menentukannya di api_key bidang saat menyiapkan klien dengan OpenAIPython SDK.

catatan

Kunci API Amazon Bedrock terbatas pada tindakan Amazon Bedrock dan Amazon Bedrock Runtime. Anda tidak dapat menggunakannya dengan operasi API berikut:

• InvokeModelWithBidirectionalStream.

• Agen untuk Amazon Bedrock atau Agen untuk operasi Amazon Bedrock Runtime API.

• Otomatisasi Data untuk Amazon Bedrock atau Runtime untuk operasi Amazon Bedrock Data Automation API.

Untuk melihat contoh penggunaan kunci API untuk mengirim permintaan Converse guna menghasilkan respons, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:

Python

Contoh berikut menunjukkan cara mengirim permintaan API dengan AWS SDK untuk Python (Boto3). Jika Anda belum menyetel kunci API sebagai variabel AWS_BEARER_TOKEN_BEDROCK lingkungan, tentukan sebagai pengganti ${api-key} dalam kode berikut:

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)

Prasyarat: Instal requests paket dengan membuka terminal dan menjalankan perintah berikut:

python3 -m pip install requests

Contoh berikut menunjukkan cara langsung mengirim permintaan API dengan klien HTTP. Tentukan ${api-key} di header.

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

Contoh berikut menunjukkan cara mengirim permintaan API secara langsung, menggunakan cURL. Jika Anda tidak menyetel kunci API sebagai variabel AWS_BEARER_TOKEN_BEDROCK lingkungan, Anda harus mengganti $AWS_BEARER_TOKEN_BEDROCK dalam contoh dengan nilai literal kunci.

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