View a markdown version of this page

Memulai dengan API - Amazon Nova
Dapatkan kredenSIAL untuk memberikan akses terprogramLampirkan izin Amazon Bedrock ke pengguna atau peranMinta akses ke model Amazon NovaMenghasilkan 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

catatan

Dokumentasi ini untuk Amazon Nova Versi 1. Amazon Nova 2 sekarang tersedia dengan model baru dan kemampuan yang ditingkatkan. Untuk informasi tentang cara memulai dengan Amazon Nova 2, kunjungi Memulai dengan API.

Untuk memulai dengan API, Anda memerlukan kredenSIAL untuk memberikan akses terprogram. Jika bagian berikut berkaitan dengan Anda, perluas dan ikuti instruksi. Jika tidak, lanjutkan melalui bagian yang tersisa.

Mendaftar untuk Akun AWS

Untuk memulainya AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat Mem ulai dengan an Akun AWS di Panduan AWS Account Management Referensi.

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

Untuk menginstal AWS SDK, pilih tab yang sesuai dengan bahasa pemrograman yang ingin Anda gunakan di Tools to Build on AWS. AWS perangkat pengembangan perangkat lunak (SDK) tersedia untuk banyak bahasa pemrograman populer. Setiap SDK menyediakan API, contoh kode, dan dokumentasi yang memudahkan developer untuk membangun aplikasi dalam bahasa pilihan mereka. SDK secara otomatis melakukan tugas-tugas yang berguna untuk Anda, seperti:

  • Tanda tangani permintaan layanan Anda secara kriptografi

  • Permintaan coba lagi

  • Menangani tanggapan kesalahan

Dapatkan kredenSIAL untuk memberikan akses terprogram

Pengguna memerlukan akses terprogram jika mereka ingin berinteraksi dengan AWS di luar. Konsol Manajemen AWS 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 kredensional jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau AWS API.

Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.
Peran IAM Gunakan kredenSIAL sementara untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau AWS API. Mengikuti petunjuk dalam Menggunakan kredenSIAL sementara dengan AWS sumber daya di Panduan Pengguna IAM.

Identitas tenaga kerja

(Pengguna yang dikelola di Pusat Identitas IAM)

 Gunakan kredenSIAL sementara untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau AWS API.

Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.

Jika Anda memutuskan untuk menggunakan kunci akses untuk pengguna IAM, Anda disarankan untuk AWS menetapkan kedaluwarsa untuk pengguna IAM dengan menyertakan kebijakan sebaris yang membatasi.

penting

Perhatikan peringatan berikut:

  • JANGAN gunakan kredentif root akun Anda untuk mengakses AWS sumber daya. KredenSIAL ini menyediakan akses akun tidak terbatas dan sulit untuk dicabut.

  • JANGAN menaruh kunci akses literal atau informasi kredensi dalam file aplikasi Anda. Jika Anda melakukannya, Anda membuat risiko mengekspos kredenSIAL Anda secara tidak sengaja jika, misalnya, Anda mengunggah proyek ke repositori publik.

  • JANGAN ser takan file yang berisi kredenSIAL di area proyek Anda.

  • Kelola kunci akses Anda dengan aman. Jangan berikan kunci akses Anda kepada pihak yang tidak berwenang, bahkan untuk membantu menemukan pengidentifikasi akun Anda. Dengan melakukan tindakan ini, Anda mungkin memberi seseorang akses permanen ke akun Anda.

  • Ketahuilah bahwa kredenSIAL apa pun yang disimpan dalam file AWS kredenSIAL bersama disimpan dalam teks biasa.

Untuk detail selengkapnya, lihat Praktik terbaik untuk mengelola kunci AWS akses di Referensi Umum AWS.

Mmebuat pengguna IAM

  1. Di halaman Konsol Manajemen AWS Beranda, pilih layanan IAM atau navigasikan ke konsol IAM di. https://console.aws.amazon.com/iam/

  2. Di panel navigasi, pilih Pengguna dan kemudian pilih Buat pengguna.

  3. Ikuti panduan di konsol IAM untuk mengatur pengguna terprogram (tanpa akses ke Konsol Manajemen AWS) dan tanpa izin.

Batasi akses pengguna ke jendela waktu terbatas

Setiap kunci akses pengguna IAM yang Anda buat adalah kredenSIAL jangka panjang. Untuk memastikan kredentif ini kedaluwarsa jika salah ditangani, Anda dapat membuat kredenSIAL ini terikat waktu dengan membuat kebijakan sebaris yang menentukan tanggal setelah kunci tidak lagi valid.

  1. Buka pengguna IAM yang baru saja Anda buat. Di tab Izin, pilih Tambah izin lalu pilih Buat kebijakan sebaris.

  2. Di editor JSON, tentukan izin berikut. Untuk menggunakan kebijakan ini, ganti nilai untuk nilai aws:CurrentTime stempel waktu dalam kebijakan contoh dengan tanggal akhir Anda sendiri.

    catatan

    IAM merekomendasikan agar Anda membatasi kunci akses Anda hingga 12 jam.

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": "*",
      "Resource": "*",
      "Condition": {
        "DateGreaterThan": {
          "aws:CurrentTime": "2024-01-01T00:00:00Z"
        }
      }
    }
  ]
}
Buat kunci akses

  1. Pada halaman Detail pengguna, pilih tab Kreden sibilitas keamanan. Pada bagian Access key, pilih Buat access key.

  2. Tunjukkan bahwa Anda berencana untuk menggunakan kunci akses ini sebagai Lain nya dan pilih Buat kunci akses.

  3. Pada halaman Ambil kunci akses, pilih Tampilkan untuk mengungkapkan nilai kunci akses rahasia pengguna Anda. Anda dapat menyalin kredensialnya atau mengunduh file.csv.

penting

Ketika Anda tidak lagi membutuhkan pengguna IAM ini, kami sarankan Anda menghapusnya dan menyelaraskan dengan praktik terbaik AWS keamanan, kami sarankan Anda meminta pengguna manusia untuk menggunakan kredenSIAL sementara melalui Pusat Identi AWS tas IAM saat mengakses. AWS

Lampirkan izin Amazon Bedrock ke pengguna atau peran

Setelah menyiapkan kredenSIAL untuk akses terprogram, Anda perlu mengonfigurasi izin untuk pengguna atau peran IAM agar dapat mengakses serangkaian tindakan Amazon Bedrock-related . Untuk mengatur izin ini, lakukan hal berikut:

  1. Di halaman Konsol Manajemen AWS Beranda, pilih layanan IAM atau navigasikan ke konsol IAM di. https://console.aws.amazon.com/iam/

  2. Pilih Pengguna atau Per an lalu pilih pengguna atau peran Anda.

  3. Di tab Izin, pilih Tam bah izin, lalu pilih Tambahkan kebijakan ter AWS kelola. Pilih kebijakan yang AmazonBedrockFullAccess AWS dikelola.

  4. Untuk mengizinkan pengguna atau peran berlangganan model, pilih Buat kebijakan sebaris lalu tentukan izin berikut di editor JSON:

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
      {
          "Sid": "MarketplaceBedrock",
          "Effect": "Allow",
          "Action": [
              "aws-marketplace:ViewSubscriptions",
              "aws-marketplace:Unsubscribe",
              "aws-marketplace:Subscribe"
          ],
          "Resource": "*"
      }
  ]
}

Minta akses ke model Amazon Nova

Minta akses ke model Amazon Nova melalui konsol Amazon Bedrock dengan mengikuti langkah-langkah di Meminta akses ke model pondasi Amazon Bedrock.

Menghasilkan respons untuk prompt teks menggunakan model Amazon Nova

Setelah memenuhi semua prasyarat, pilih tab untuk menguji pembuatan permintaan pemanggilan model ke model Amazon Nova dengan permintaan Converse dan menggunakan metode yang ditentukan di tab:

AWS CLI

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

Untuk menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan AWS CLI, jalankan perintah berikut di terminal:

aws bedrock-runtime converse \
    --model-id us.amazon.nova-lite-v1:0 \
    --messages '[{"role": "user", "content": [{"text": "Write a short poem"}]}]'
Python (Boto3)

Untuk menginstal Boto3, ikuti langkah-langkah di Quickstart dalam dokumentasi Boto3. Verifikasi bahwa Anda telah menyiapkan kredensi untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. Dapatkan kredenSIAL untuk memberikan akses terprogram

Untuk membuat klien Amazon Bedrock Runtime dan menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan Python SDK (Boto3), jalankan skrip Python berikut:

import boto3
import json

client = boto3.client(service_name="bedrock-runtime")

messages = [
    {"role": "user", "content": [{"text": "Write a short poem"}]},
]

model_response = client.converse(
    modelId="us.amazon.nova-lite-v1:0", 
    messages=messages
)

print("\n[Full Response]")
print(json.dumps(model_response, indent=2))

print("\n[Response Content Text]")
print(model_response["output"]["message"]["content"][0]["text"])
LangChain

LangChain Untuk menginstal AWS, ikuti langkah-langkah di AWS dalam LangChain dokumentasi. Verifikasi bahwa Anda telah menyiapkan kredensi untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. Dapatkan kredenSIAL untuk memberikan akses terprogram

Untuk menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan LangChain, jalankan skrip berikut:

from langchain_aws import ChatBedrockConverse

llm = ChatBedrockConverse(model="us.amazon.nova-lite-v1:0")

messages = [
    ("user", "Write a short poem")
]

llm.invoke(messages)

Setelah Anda membiasakan diri dengan Amazon Nova, Anda dapat melanjutkan ke tugas yang lebih maju:

  1. Coba minta model untuk menggambarkan gambar atau video. Untuk informasi selengkapnya, lihat Dukungan multimodal untuk Amazon Nova.

  2. Coba buat gambar menggunakan Amazon Nova Canvas. Untuk informasi selengkapnya, lihat Menghasilkan gambar dengan Amazon Nova Canvas.

  3. Coba buat video menggunakan Amazon Nova Reel. Untuk informasi selengkapnya, lihat Menghasilkan video dengan Amazon Nova Reel.

  4. Kirim model dokumen dan tanyakan tentang isinya. Untuk informasi selengkapnya, lihat Pemahaman dokumen.

  5. Berikan model dengan alat dan buat permintaan dengan prompt untuk melihatnya menggunakan alat. Untuk informasi selengkapnya, lihat Penggunaan alat (panggilan fungsi) dengan Amazon Nova.