Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan API
Sebelum Anda memulai APIs, ikuti prosedur ini jika Anda baru AWS atau perlu menginstal AWS CLI atau SDK. AWS Jika tidak satu pun dari ini berlaku untuk Anda, pindah ke[Dapatkan kredensil untuk memberikan akses terprogram](#grant-program-access).
## Saya baru AWS
Jika Anda tidak memiliki AWS akun, selesaikan langkah-langkah berikut untuk membuatnya. Atau, Anda dapat mulai membangun secara gratis dengan Amazon Nova di [nova.amazon.com/dev](https://nova.amazon.com/dev).
**Untuk mendaftar AWS akun**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.
Saat Anda mendaftar untuk AWS akun, *pengguna root AWS akun* dibuat. Pengguna root memiliki akses ke semua AWS layanan dan sumber daya di akun. Sebagai praktik terbaik keamanan, tetapkan akses administratif ke pengguna dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS mengirimi Anda email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk [https://aws.amazon.com.rproxy.govskope.uske/](https://aws.amazon.com/) dan memilih **Akun Saya**.
**Amankan pengguna root AWS akun Anda**
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)sebagai pemilik akun dengan memilih **pengguna Root** dan memasukkan alamat email AWS akun Anda. Di laman berikutnya, masukkan kata sandi.
Untuk bantuan masuk menggunakan pengguna root, lihat [Masuk sebagai pengguna root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) di *Panduan Pengguna AWS Masuk*.
1. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.
Untuk petunjuk, lihat [Mengaktifkan perangkat MFA virtual untuk pengguna root AWS akun (konsol) Anda di Panduan Pengguna](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) *IAM*.
## Saya perlu menginstal AWS CLI atau SDK AWS
Untuk menginstal AWS CLI, ikuti langkah-langkah di [Instal atau perbarui ke versi terbaru CLI AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Untuk menginstal AWS SDK, pilih tab yang sesuai dengan bahasa pemrograman yang ingin Anda gunakan di [Tools to Build on AWS](https://aws.amazon.com/developer/tools/).
AWS kit pengembangan perangkat lunak (SDKs) tersedia untuk banyak bahasa pemrograman populer. Setiap SDK menyediakan API, contoh kode, dan dokumentasi yang memudahkan pengembang untuk membangun aplikasi dalam bahasa pilihan mereka. SDKs secara otomatis melakukan tugas-tugas yang berguna untuk Anda, seperti:
+ Tanda tangani permintaan layanan Anda secara kriptografis
+ Permintaan coba lagi
+ Menangani tanggapan kesalahan
## Dapatkan kredensil untuk memberikan akses terprogram
Pengguna memerlukan akses terprogram jika mereka ingin berinteraksi dengan AWS di luar Konsol AWS Manajemen. Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS.
Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut.
| Prinsipal mana yang membutuhkan akses terprogram? | Untuk | Oleh |
| --- | --- | --- |
| Pengguna IAM: | Batasi durasi kredensyal jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, atau. AWS SDKs AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/nova/latest/nova2-userguide/getting-started-api.html) |
| Peran IAM | Gunakan kredensyal sementara untuk menandatangani permintaan terprogram ke AWS CLI,, atau. AWS SDKs AWS APIs | Ikuti petunjuk di [Menggunakan kredensyal sementara dengan AWS sumber daya di Panduan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) Pengguna IAM. |
| Pengguna dikelola di Pusat Identitas IAM | Gunakan kredensyal sementara untuk menandatangani permintaan terprogram ke AWS CLI,, atau. AWS SDKs AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/nova/latest/nova2-userguide/getting-started-api.html) |
## Lampirkan izin Amazon Bedrock ke pengguna atau peran
Setelah menyiapkan kredensyal untuk akses terprogram, Anda perlu mengonfigurasi izin untuk peran pengguna atau IAM agar memiliki akses ke tindakan terkait Amazon Bedrock. Untuk mengatur izin ini, lakukan hal berikut:
1. Pada halaman Beranda Konsol AWS Manajemen, pilih layanan IAM atau navigasikan ke konsol IAM di. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Pilih **Pengguna** atau **Peran** dan kemudian pilih pengguna atau peran Anda.
1. Di tab **Izin**, pilih **Tambahkan izin**, lalu pilih **Tambahkan kebijakan AWS terkelola**. Pilih kebijakan [AmazonBedrockFullAccess](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonBedrockFullAccess) AWS terkelola.
1. Untuk mengizinkan pengguna atau peran berlangganan model, pilih **Buat kebijakan sebaris** lalu tentukan izin berikut di editor JSON:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "MarketplaceBedrock",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Unsubscribe",
"aws-marketplace:Subscribe"
],
"Resource": "*"
}
]
}
```
## Hasilkan respons untuk prompt teks menggunakan model Amazon Nova
[Setelah memenuhi semua prasyarat, Anda dapat menguji pembuatan permintaan permintaan model ke model Amazon Nova dengan permintaan Converse.](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)
Untuk menginstal AWS CLI, ikuti langkah-langkah di [Instal atau perbarui ke versi terbaru CLI AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Verifikasi bahwa Anda telah menyiapkan kredensil Anda untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. [Dapatkan kredensil untuk memberikan akses terprogram](#grant-program-access)
Untuk menghasilkan respons untuk prompt teks di Nova 2 Lite dengan menggunakan AWS CLI, jalankan perintah berikut di terminal:
```
aws bedrock-runtime converse \
--model-id us.amazon.nova-2-lite-v1:0 \
--messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \
--additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'
```