Proofreader API

Thomas Steiner

Alexandra Klepper

Dipublikasikan: 4 September 2025

Penjelasan	Web	Ekstensi	Status Chrome	Intent
GitHub	Uji coba asal	Uji coba asal	View	Maksud untuk Membuat Prototipe

Pemeriksaan tata bahasa adalah proses mencari dan mengoreksi kesalahan tata bahasa, ejaan, dan tanda baca. Browser dan sistem operasi makin sering menawarkan koreksi ejaan pada alat penulisan mereka, seperti di Google Dokumen.

Dengan Proofreader API, Anda dapat menyediakan koreksi interaktif untuk aplikasi atau ekstensi web Anda, dengan AI bawaan. API ini menawarkan fungsi berikut:

• Koreksi: Mengoreksi input pengguna untuk tata bahasa, ejaan, dan tanda baca.
• Label: Beri label pada setiap koreksi berdasarkan jenis error.
• Penjelasan: Mendefinisikan apa yang salah atau mengapa koreksi diperlukan dengan bahasa yang sederhana.

Kasus penggunaan

Ada banyak alasan mengapa Anda mungkin ingin menggunakan Proofreader API. Misalnya:

• Sarankan koreksi pada pesan forum, komentar pada artikel, dan email, sebelum postingan dikirimkan.
• Memberikan koreksi selama pencatatan aktif.

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

Mulai

Ikuti uji coba origin Proofreader API, yang berjalan di Chrome 141 hingga 145.

Menambahkan dukungan ke localhost

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

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

Mendaftar untuk uji coba origin

Untuk mulai menggunakan Proofreader API, ikuti langkah-langkah berikut:

1. Konfirmasi Kebijakan Penggunaan Terlarang untuk AI Generatif Google.
2. Buka uji coba origin Proofreader 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.
   • Jika Anda membuat Ekstensi, ikuti petunjuk uji coba origin Ekstensi
6. Mulai menggunakan Proofreader API.

Pelajari lebih lanjut cara mulai menggunakan uji coba origin.

Menggunakan Proofreader API

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

const options = {
  expectedInputLanguages: ['en'],
};
const available = if (Proofreader.availability("downloadable") === true);

Untuk memicu download dan membuat instance proofreader, periksa aktivasi pengguna. Kemudian, panggil fungsi asinkron Proofreader.create().

const session = await Proofreader.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
  ...options,
});

Membuat objek Proofreader

Untuk membuat Proofreader, gunakan fungsi Proofreader.create().

const proofreader = await Proofreader.create({
  expectedInputLanguages: ["en"],
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(Downloaded ${e.loaded * 100}%);
    });
  }
};

Metode create() mencakup opsi berikut:

• expectedInputLanguages: Array bahasa input yang diharapkan.

Opsi includeCorrectionTypes dan includeCorrectionExplanation dari penjelasan tidak didukung.

Mulai mengoreksi teks pengguna

Panggil proofread() untuk mendapatkan koreksi pada teks input:

const proofreadResult = await proofreader.proofread(
  'I seen him yesterday at the store, and he bought two loafs of bread.',
);

Koreksi adalah jenis ProofreadResult. Temukan input yang telah dikoreksi sepenuhnya di atribut corrected dan daftar koreksi dalam array corrections:

let inputRenderIndex = 0;

console.log(proofreadResult.correction);

for (const correction of proofreadResult.corrections) {
  // Render part of input that has no error.
  if (correction.startIndex > inputRenderIndex) {
    const unchangedInput = document.createElement('span');
    unchangedInput.textContent = input.substring(inputRenderIndex, correction.startIndex);
    editBox.append(unchangedInput);
  }
  // Render part of input that has an error and highlight as such.
  const errorInput = document.createElement('span');
  errorInput.textContent = input.substring(correction.startIndex, correction.endIndex);
  errorInput.classList.add('error');
  editBox.append(errorInput);
  inputRenderIndex = correction.endIndex;
}

// Render the rest of the input that has no error.
if (inputRenderIndex !== input.length){
  const unchangedInput = document.createElement('span');
  unchangedInput.textContent = input.substring(inputRenderIndex, input.length);
  editBox.append(unchangedInput);
}

Permission Policy, iframe, dan Web Worker

Secara default, Proofreader API hanya tersedia untuk jendela tingkat teratas dan iframe yang memiliki origin 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 Proofreader API by
  setting the `allow="proofreader"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="proofreader"></iframe>

Proofreader API tidak tersedia di Web Workers. Hal ini disebabkan oleh kompleksitas dalam menetapkan dokumen yang bertanggung jawab untuk setiap pekerja, guna memeriksa status Kebijakan Izin.

Demo

Bereksperimen dengan Proofreader API playground.

Berinteraksi dan memberikan masukan

Proofreader API sedang dalam tahap pembahasan aktif dan dapat berubah 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
• Baca posisi Standar Mozilla dan posisi Standar WebKit.
• Bergabunglah dengan program pratinjau awal untuk melihat API baru lebih awal 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 model bahasa besar, di browser.