Mulai menggunakan AI bawaan

AI_USAGE=false

Alexandra Klepper

Dipublikasikan: 12 Desember 2024, Terakhir diperbarui: 20 Mei 2025

Dengan API AI bawaan, aplikasi web Anda dapat melakukan tugas yang didukung AI tanpa perlu men-deploy atau mengelola model AI-nya sendiri. Kami sedang berupaya menstandarkan API ini di berbagai browser.

Persyaratan

Untuk menggunakan AI bawaan, ada persyaratan model dan hardware.

Model

Prompt API, Summarizer API, Writer API, dan Rewriter API mendownload model bahasa besar yang dirancang untuk dijalankan secara lokal di komputer desktop dan laptop. API ini tidak berfungsi di perangkat seluler. Sebelum Anda menggunakan API ini, Anda harus menyetujui Kebijakan Penggunaan Terlarang untuk AI Generatif Google.

Summarizer API, Writer API, dan Rewriter API hanya mendukung modalitas text-to-text. Prompt API memiliki kemampuan multimodal yang tersedia untuk pembuatan prototipe lokal bagi Peserta Program Pratinjau Awal.

Hardware

Persyaratan berikut berlaku untuk developer dan pengguna yang mengoperasikan fitur menggunakan API ini di Chrome. Browser lain mungkin memiliki persyaratan pengoperasian yang berbeda.

Language Detector API dan Translator API berfungsi di Chrome di desktop. API ini tidak berfungsi di perangkat seluler. Prompt API, Summarizer API, Writer API, dan Rewriter API berfungsi di Chrome jika persyaratan berikut terpenuhi:

  • Sistem operasi: Windows 10 atau 11; macOS 13+ (Ventura dan yang lebih baru); atau Linux. Chrome untuk Android, iOS, dan ChromeOS belum didukung oleh API yang menggunakan Gemini Nano.
  • Penyimpanan: Minimal 22 GB ruang kosong pada volume yang berisi profil Chrome Anda.
  • GPU: Lebih dari 4 GB VRAM.
  • Jaringan: Data tanpa batas atau koneksi tanpa kuota.

Ukuran pasti Gemini Nano dapat bervariasi saat browser mengupdate model. Untuk menentukan ukuran saat ini, buka chrome://on-device-internals dan buka Status model. Buka Jalur file yang tercantum untuk menentukan ukuran model.

Mulai membuat

Ada beberapa API AI bawaan yang tersedia di berbagai tahap pengembangan. Beberapa fitur ada di Chrome stabil, beberapa fitur tersedia untuk peserta uji coba origin, dan fitur lainnya hanya tersedia untuk peserta Program Pratinjau Awal.

Setiap API memiliki serangkaian petunjuknya sendiri untuk memulai dan mendownload model, baik untuk pembuatan prototipe lokal maupun di lingkungan produksi dengan uji coba origin.

Semua API ini dapat digunakan saat membuat Ekstensi Chrome.

Download model

API dan modelnya sudah terintegrasi ke dalam Chrome. Saat pengguna berinteraksi dengan API ini untuk pertama kalinya, model harus didownload ke browser.

Untuk menentukan apakah API dapat digunakan dan siap, panggil fungsi availability() asinkron, yang menampilkan promise dengan salah satu nilai berikut:

  • "unavailable": Opsi sesi yang diminta atau perangkat pengguna tidak didukung. Perangkat mungkin tidak memiliki daya atau ruang disk yang cukup.
  • "downloadable": Download tambahan diperlukan untuk membuat sesi, yang dapat mencakup model pakar, model bahasa, atau penyesuaian. Aktivasi pengguna mungkin diperlukan untuk memanggil create().
  • "downloading": Download sedang berlangsung dan harus selesai sebelum Anda dapat menggunakan sesi.
  • "available": Anda dapat membuat sesi secara langsung.

Pengaktifan pengguna

Interaksi pengguna diperlukan untuk mendownload model dan konfigurasi yang diperlukan ke browser. Jika situs atau aplikasi web Anda adalah interaksi pertama pengguna dengan API AI bawaan tertentu, interaksi pengguna sementara diperlukan untuk memulai sesi dengan create().

Gunakan properti UserActivation.isActive` untuk mengonfirmasi aktivasi pengguna, yang dapat berupa klik, ketuk, atau penekanan tombol.

// Check for user activation.
if (navigator.userActivation.isActive) {
  // Create an instance of a built-in API
}

Misalnya dengan Summarizer API, Anda dapat meminta pengguna berinteraksi dengan tombol yang bertuliskan "Ringkas" untuk mengaktifkan Summarizer.create().

Menggunakan API di localhost

Semua API tersedia di localhost di Chrome.

  1. Buka chrome://flags/#prompt-api-for-gemini-nano.
  2. Pilih Enabled.
  3. Klik Luncurkan kembali atau mulai ulang Chrome.

Untuk mengonfirmasi bahwa Gemini Nano telah didownload dan berfungsi sebagaimana mestinya, buka DevTools dan ketik await LanguageModel.availability(); ke dalam konsol. Tindakan ini akan menampilkan available.

Memecahkan masalah localhost

Jika model tidak berfungsi seperti yang diharapkan, ikuti langkah-langkah berikut:

  1. Mulai ulang Chrome.
  2. Buka chrome://components.
  3. Pastikan Optimization Guide On Device Model ada. Artinya, Gemini Nano tersedia atau sedang didownload.
    • Jika tidak ada nomor versi yang tercantum, klik Periksa update untuk memaksa download.
  4. Buka DevTools dan ketik LanguageModel.availability(); ke dalam konsol. Tindakan ini akan menampilkan available.

Jika perlu, tunggu beberapa saat dan ulangi langkah-langkah ini.

Proses standar

Kami berupaya menstandarkan API ini, sehingga API ini berfungsi di semua browser. Artinya, kami telah mengusulkan API tersebut kepada komunitas platform web, dan memindahkannya ke W3C Web Incubator Community Group untuk didiskusikan lebih lanjut.

Kami meminta masukan dari W3C, Mozilla, dan WebKit untuk setiap API.

Berinteraksi dan memberikan masukan

Jika Anda mencoba AI bawaan dan memiliki masukan, kami ingin mendengarnya.