Rewriter API

Alexandra Klepper

Thomas Steiner

Dipublikasikan: 20 Mei 2025

Penjelasan	Web	Ekstensi	Status Chrome	Intent
GitHub	Uji coba asal	Uji coba asal	View	Niat untuk Bereksperimen

Rewriter API membantu Anda merevisi dan menyusun ulang teks. API ini dan Writer API adalah bagian dari proposal Writing Assistance API.

API ini dapat membantu Anda meningkatkan kualitas konten yang dibuat oleh pengguna.

Kasus penggunaan

Perbaiki teks yang ada dengan membuatnya lebih panjang atau lebih pendek, atau mengubah gaya bahasa. Misalnya, Anda dapat:

• Tulis ulang email singkat agar terdengar lebih sopan dan formal.
• Menyarankan pengeditan pada ulasan pelanggan untuk membantu pelanggan lain memahami masukan atau menghapus kata-kata tidak sopan.
• Format konten untuk memenuhi ekspektasi audiens tertentu.

Apakah kasus penggunaan Anda tidak ada? Bergabunglah dengan program pratinjau awal untuk memberikan masukan.

Mulai

Bergabung dengan uji coba origin Rewriter API, yang berjalan di Chrome 137 hingga 142.

Mendaftar untuk uji coba origin

Rewriter API tersedia dalam uji coba origin bersama dengan Writer API. Untuk mulai menggunakan API ini:

1. Konfirmasi Kebijakan Penggunaan Terlarang untuk AI Generatif Google.
2. Buka uji coba origin Rewriter API.
3. Klik Daftar dan isi formulirnya. Di kolom Asal web, berikan asal atau ID ekstensi Anda, chrome-extension://YOUR_EXTENSION_ID.
4. Untuk mengirimkan, klik Daftar.
5. Salin token yang diberikan, lalu tambahkan ke setiap halaman web yang berpartisipasi di origin Anda atau sertakan dalam manifes Ekstensi Anda.
6. Mulai menggunakan Rewriter API.

Pelajari lebih lanjut cara mulai menggunakan uji coba origin.

Menambahkan dukungan ke localhost

Untuk mengakses Writer dan Rewriter API di localhost selama uji coba origin, Anda harus mengupdate Chrome ke versi terbaru. Selanjutnya, ikuti langkah-langkah berikut:

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

Menggunakan Rewriter API

Pertama, jalankan deteksi fitur untuk melihat apakah browser mendukung API ini.

if ('Rewriter' in self) {   // The Rewriter API is supported. } 

Rewriter API, dan semua API AI bawaan lainnya, terintegrasi di browser. Gemini Nano didownload secara terpisah saat pertama kali situs menggunakan API AI bawaan. Dalam praktiknya, jika pengguna telah berinteraksi dengan API bawaan, mereka telah mendownload model ke browser mereka.

Untuk menentukan apakah model siap digunakan, panggil fungsi asinkron Rewriter.availability(). Jika respons terhadap availability() adalah downloadable, dengarkan progres download dan beri tahu pengguna, karena download mungkin memerlukan waktu.

const availability = await Rewriter.availability(); 

Untuk memicu download model dan memulai penulis ulang, periksa aktivasi pengguna dan panggil fungsi Rewriter.create().

const rewriter = await Rewriter.create({   monitor(m) {     m.addEventListener("downloadprogress", e => {       console.log(`Downloaded ${e.loaded * 100}%`);     });   } }); 

Fungsi API

Fungsi create() memungkinkan Anda mengonfigurasi objek penulis ulang baru. Metode ini menggunakan objek options opsional dengan parameter berikut:

• tone: Nuansa penulisan dapat merujuk pada gaya, karakter, atau sikap konten. Nilai dapat ditetapkan ke more-formal, as-is (default), atau more-casual.
• format: Pemformatan output, dengan nilai yang diizinkan as-is (default), markdown, dan plain-text.
• length: Panjang output, dengan nilai yang diizinkan shorter, as-is (default), dan longer.
• sharedContext: Saat menulis ulang beberapa konten, konteks bersama dapat membantu model membuat konten yang lebih sesuai dengan ekspektasi Anda.

Contoh berikut menunjukkan cara memulai objek rewriter:

const options = {   sharedContext: 'This is an email to acquaintances about an upcoming event.',   tone: 'more-casual',   format: 'plain-text',   length: 'shorter', };  const available = await Rewriter.availability(); let rewriter; if (available === 'unavailable') {   // The Rewriter API isn't usable.   return; } if (available === 'available') {   // The Rewriter API can be used immediately .   rewriter = await Rewriter.create(options); } else {   // The Rewriter can be used after the model is downloaded.   rewriter = await Rewriter.create(options);   rewriter.addEventListener('downloadprogress', (e) => {     console.log(e.loaded, e.total);   }); } 

Mulai menulis ulang

Ada dua cara untuk menghasilkan konten dari model: non-streaming dan streaming.

Output non-streaming

Dengan penulisan ulang non-streaming, model memproses input secara keseluruhan, lalu menghasilkan output.

Untuk mendapatkan output non-streaming, panggil fungsi asinkron rewrite(). Anda harus menyertakan teks awal yang ingin ditulis ulang. Anda dapat menambahkan context opsional untuk memberikan informasi latar belakang model, yang dapat membantu model memenuhi ekspektasi Anda terhadap output dengan lebih baik.

// Non-streaming const rewriter = await Rewriter.create({   sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc." }); const result = await rewriter.rewrite(reviewEl.textContent, {   context: "Avoid any toxic language and be as constructive as possible." }); 

Output penulisan ulang streaming

Streaming menawarkan hasil secara real-time. Output diperbarui secara berkelanjutan saat input ditambahkan dan disesuaikan.

Untuk mendapatkan penulis ulang streaming, panggil fungsi rewriteStreaming() dan lakukan iterasi pada segmen teks yang tersedia dalam streaming. Anda dapat menambahkan context opsional untuk memberikan informasi latar belakang model, yang dapat membantu model memenuhi ekspektasi Anda terhadap output dengan lebih baik.

const rewriter = await Rewriter.create({   sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc." });  const stream = rewriter.rewriteStreaming(reviewEl.textContent, {   context: "Avoid any toxic language and be as constructive as possible.",   tone: "more-casual", });  for await (const chunk of stream) {   composeTextbox.append(chunk); } 

Membagikan konteks untuk beberapa tugas

Anda dapat menggunakan rewriter untuk membuat beberapa konten. Dalam hal ini, sebaiknya tambahkan sharedContext. Misalnya, Anda mungkin ingin membantu peninjau memberikan masukan yang lebih baik dalam komentar.

// Shared context and per writing task context const rewriter = await Rewriter.create({   sharedContext: "This is for publishing on [popular website name], a business and employment-focused social media platform." });  const stream = rewriter.rewriteStreaming(   "Love all this work on generative AI at Google! So much to learn and so many new things I can do!",   {     context: "The request comes from someone working at a startup providing an e-commerce CMS solution.",     tone: "more-casual",   } );  for await (const chunk of stream) {   composeTextbox.append(chunk); } 

Menggunakan kembali alat tulis ulang

Anda dapat menggunakan penulis ulang yang sama untuk mengedit beberapa konten. Hal ini dapat sangat berguna jika menambahkan penulis ulang ke alat masukan atau komentar, untuk membantu penulis memberikan masukan yang produktif dan bermanfaat.

// Reusing a rewriter const rewriter = await Rewriter.create({   sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc." });  const rewrittenReviews = await Promise.all(   Array.from(     document.querySelectorAll("#reviews > .review"),     (reviewEl) => rewriter.rewrite(reviewEl.textContent, {       context: "Avoid any toxic language and be as constructive as possible.",       tone: "more-casual",     })   ), ); 

Menghentikan penulis ulang

Untuk mengakhiri proses penulisan ulang, batalkan pengontrol dan hancurkan rewriter.

// Stop a rewriter const controller = new AbortController(); stopButton.onclick = () => controller.abort();  const rewriter = await Rewriter.create({ signal: controller.signal }); await rewriter.rewrite(reviewEl.textContent, { signal: controller.signal });  // Destroy a rewriter rewriter.destroy(); 

Demo

Permission Policy, iframe, dan Web Worker

Secara default, Rewriter API hanya tersedia untuk jendela tingkat teratas dan iframe sumber yang sama. Akses ke API dapat didelegasikan ke iframe lintas origin menggunakan atribut allow="" Kebijakan Izin:

<!--   The hosting site at https://main.example.com can grant a cross-origin iframe   at https://cross-origin.example.com/ access to the Rewriter API by   setting the `allow="rewriter"` attribute. --> <iframe src="https://cross-origin.example.com/" allow="rewriter"></iframe> 

Prompt API belum tersedia di Web Workers untuk saat ini, karena kompleksitas menetapkan dokumen yang bertanggung jawab untuk setiap pekerja guna memeriksa status kebijakan izin.

Berinteraksi dan memberikan masukan

Writer API dan Rewriter API sedang dalam tahap pembahasan aktif dan dapat berubah sewaktu-waktu di masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, kami ingin mendengarnya.

• Baca penjelasan, ajukan pertanyaan, dan berpartisipasi dalam diskusi.
• Tinjau penerapan untuk Chrome di Status Chrome.
• Bergabunglah ke program pratinjau awal untuk melihat lebih awal API baru dan mendapatkan akses ke milis kami.
• Jika Anda memiliki masukan tentang penerapan Chrome, laporkan bug Chromium.

Temukan semua API AI bawaan yang menggunakan model, termasuk Gemini Nano dan model pakar lainnya, di browser.