View a markdown version of this page

Memulai dengan API - Amazon Nova
Dapatkan kredensil untuk memberikan akses terprogramLampirkan izin Amazon Bedrock ke pengguna atau peranHasilkan respons untuk prompt teks menggunakan model Amazon Nova

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 keDapatkan kredensil untuk memberikan akses terprogram.

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.

Untuk mendaftar AWS akun

  1. Buka https://portal.aws.amazon.com/billing/pendaftaran.

  2. 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.

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/ dan memilih Akun Saya.

Amankan pengguna root AWS akun Anda

  1. Masuk ke Konsol Manajemen AWSsebagai 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 di Panduan Pengguna AWS Masuk.

  2. 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 IAM.

Untuk menginstal AWS CLI, ikuti langkah-langkah di Instal atau perbarui ke versi terbaru CLI AWS.

Untuk menginstal AWS SDK, pilih tab yang sesuai dengan bahasa pemrograman yang ingin Anda gunakan di Tools to Build on AWS.

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.
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 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.

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/

  2. Pilih Pengguna atau Peran dan kemudian pilih pengguna atau peran Anda.

  3. Di tab Izin, pilih Tambahkan izin, lalu pilih Tambahkan kebijakan AWS terkelola. Pilih kebijakan AmazonBedrockFullAccess AWS terkelola.

  4. 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.

Untuk menginstal AWS CLI, ikuti langkah-langkah di Instal atau perbarui ke versi terbaru CLI AWS. Verifikasi bahwa Anda telah menyiapkan kredensil Anda untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. Dapatkan kredensil untuk memberikan akses terprogram

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