

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

# Memulai kunci Amazon Bedrock API: Buat kunci 30 hari dan lakukan panggilan API pertama Anda
<a name="getting-started-api-keys"></a>

Tutorial ini memandu Anda untuk membuat kunci API Amazon Bedrock jangka panjang yang kedaluwarsa dalam 30 hari dan menggunakannya untuk membuat panggilan API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) sederhana menggunakan Python. Ini adalah cara tercepat untuk mulai bereksperimen dengan Amazon Bedrock tanpa menyiapkan kredensi yang rumit AWS .

**Awas**  
Kunci API jangka panjang direkomendasikan hanya untuk eksplorasi dan pengembangan Amazon Bedrock. Untuk aplikasi produksi, gunakan [alternatif untuk kunci akses jangka panjang](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) seperti peran IAM atau kredensi sementara.

Ikuti langkah-langkah berikut untuk membuat kunci API Amazon Bedrock jangka panjang yang kedaluwarsa dalam 30 hari:

1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

1. Di panel navigasi kiri, pilih **kunci API**.

1. Di tab **Kunci API jangka panjang**, pilih **Hasilkan kunci API jangka panjang**.

1. Di bagian **kedaluwarsa kunci API**, pilih **30 hari**.

1. Pilih **Hasilkan**. Kunci yang Anda hasilkan memberikan izin untuk melakukan tindakan dasar Amazon Bedrock inti, sebagaimana didefinisikan dalam kebijakan terlampir [AmazonBedrockLimitedAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockLimitedAccess).

1. Salin kunci API yang dihasilkan dan simpan dengan aman. Anda akan membutuhkan kunci ini untuk langkah selanjutnya.
**penting**  
Kunci API hanya ditampilkan sekali. Pastikan untuk menyalin dan menyimpannya sebelum menutup dialog. Ingat bahwa kunci API Anda akan kedaluwarsa dalam 30 hari. Anda dapat membuat yang baru dengan mengikuti langkah yang sama, atau mempertimbangkan untuk beralih ke metode otentikasi yang lebih aman untuk penggunaan berkelanjutan.

1. Tetapkan kunci API sebagai variabel lingkungan *\$1\$1api-key\$1* dengan menggantinya dengan nilai kunci API yang Anda hasilkan dan gunakan untuk menghasilkan respons dalam metode pilihan Anda:

------
#### [ Python ]

   ```
   import boto3
   import os
   
   # Set the API key as an environment variable
   os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"
   
   # Create the Bedrock client
   client = boto3.client(
       service_name="bedrock-runtime",
       region_name="us-east-1"
   )
   
   # Define the model and message
   model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
   messages = [{"role": "user", "content": [{"text": "Hello! Can you tell me about Amazon Bedrock?"}]}]
   
   # Make the API call
   response = client.converse(
       modelId=model_id,
       messages=messages,
   )
   
   # Print the response
   print(response['output']['message']['content'][0]['text'])
   ```

------
#### [ HTTP client using Python ]

   ```
   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 -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 ${api-key}" \
     -d '{
       "messages": [
           {
               "role": "user",
               "content": [{"text": "Hello"}]
           }
       ]
     }'
   ```

------

Selamat\$1 Anda telah berhasil membuat kunci Amazon Bedrock API dan melakukan panggilan API pertama Anda ke layanan Amazon Bedrock. Setelah menjelajahi beberapa tindakan Amazon Bedrock lainnya, Anda harus beralih ke metode otentikasi yang lebih aman seperti kunci Amazon Bedrock API jangka pendek atau kredenal sementara AWS-wide. Lihat sumber daya berikut untuk mempelajari lebih lanjut:
+ **Jelajahi berbagai model** — Pelajari tentang model dasar lain yang tersedia di Amazon Bedrock di [Informasi model pondasi Amazon Bedrock](foundation-models-reference.md) dan ubah kode Anda untuk mencobanya. `model_id`
+ **Pelajari tentang inferensi model** — Pelajari tentang menghasilkan respons dengan inferensi model dengan membaca tentang konsep dan opsi yang tersedia di Amazon Bedrock di. [Kirim petunjuk dan hasilkan tanggapan dengan inferensi model](inference.md)
+ **Rencanakan produksi dengan metode otentikasi yang lebih aman** — Baca tentang kunci Amazon Bedrock API secara lebih rinci di chapter Build dan cara membuat kunci Amazon Bedrock API jangka pendek yang lebih aman. Ketika Anda siap untuk membangun aplikasi produksi, Anda juga harus meninjau [alternatif untuk kunci akses jangka panjang](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) untuk opsi yang lebih aman yang juga memungkinkan akses ke AWS layanan lain.