Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan kunci Amazon Bedrock API
<a name="api-keys-use"></a>

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

**catatan**  
Kunci API Amazon Bedrock terbatas pada tindakan Amazon Bedrock dan [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) [Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html). Anda tidak dapat menggunakannya dengan operasi API berikut:  
[InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html).
[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) atau [Agen untuk operasi Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html).
[Otomatisasi Data untuk Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Data_Automation_for_Amazon_Bedrock.html) atau [Runtime untuk operasi Amazon Bedrock Data Automation API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Runtime_for_Amazon_Bedrock_Data_Automation).

Untuk melihat contoh penggunaan kunci API untuk mengirim permintaan [Converse guna](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 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 *\$1\$1api-key\$1* 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 *\$1\$1api-key\$1* 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\$1BEARER\$1TOKEN\$1BEDROCK 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"}]
        }
    ]
  }'
```

------