Proofreader API

Thomas Steiner

Alexandra Klepper

เผยแพร่เมื่อวันที่ 12 กันยายน 2025

วิดีโออธิบาย	เว็บ	ส่วนขยาย	สถานะ Chrome	ความตั้งใจ
GitHub	การทดลองใช้สำหรับนักพัฒนาแอป	การทดลองใช้สำหรับนักพัฒนาแอป	ดู	ความตั้งใจที่จะทดลอง

การพิสูจน์อักษรคือกระบวนการค้นหาและแก้ไขข้อผิดพลาดด้านไวยากรณ์ การสะกด และเครื่องหมายวรรคตอน เบราว์เซอร์และระบบปฏิบัติการได้นำเสนอการพิสูจน์อักษรในเครื่องมือการเขียนมากขึ้นเรื่อยๆ เช่น ใน Google เอกสาร

Proofreader API ช่วยให้คุณสามารถนำเสนอการพิสูจน์อักษรแบบโต้ตอบให้กับเว็บแอปพลิเคชันหรือส่วนขยายของคุณด้วย AI ในตัว โดย API นี้มีฟังก์ชันดังต่อไปนี้

• การแก้ไข: แก้ไขอินพุตของผู้ใช้ด้านไวยากรณ์ การสะกด และเครื่องหมายวรรคตอน
• ป้ายกำกับ: ติดป้ายกำกับข้อผิดพลาดแต่ละรายการตามประเภทข้อผิดพลาด
• คำอธิบาย: อธิบายข้อผิดพลาดหรือเหตุผลที่ต้องแก้ไข ด้วยภาษาธรรมดา

กรณีการใช้งาน

มีหลายเหตุผลที่คุณอาจต้องการใช้ Proofreader API เช่น

• แนะนำการแก้ไขข้อความในฟอรัม ความคิดเห็นในบทความ และอีเมล ก่อนที่จะส่งโพสต์
• ให้การแก้ไขระหว่างการจดบันทึก

หากไม่พบกรณีการใช้งานของคุณ โปรดเข้าร่วมโปรแกรมทดลองใช้ก่อนเปิดตัว เพื่อแชร์ความคิดเห็น

เริ่มต้นใช้งาน

เข้าร่วมช่วงทดลองใช้จากต้นทาง Proofreader API ซึ่งจะทำงานใน Chrome 141 ถึง 145

เพิ่มการรองรับ localhost

AI API ในตัวทั้งหมดพร้อมใช้งานใน localhost ใน Chrome ตั้งค่าสถานะ ต่อไปนี้เป็น เปิดใช้:

• chrome://flags/#optimization-guide-on-device-model
• chrome://flags/#prompt-api-for-gemini-nano-multimodal-input
• chrome://flags/#proofreader-api-for-gemini-nano

จากนั้นคลิกเปิดใหม่ หรือรีสตาร์ท Chrome หากพบข้อผิดพลาด ให้แก้ปัญหา localhost

ลงชื่อสมัครเข้าร่วมช่วงทดลองใช้จากต้นทาง

หากต้องการเริ่มใช้ Proofreader API ให้ทำตามขั้นตอนต่อไปนี้

1. รับทราบนโยบายการใช้งานที่ไม่อนุญาตสำหรับ Generative AI ของ Google
2. ไปที่ช่วงทดลองใช้ Proofreader API จากต้นทาง
3. คลิกลงทะเบียน แล้วกรอกข้อมูลในแบบฟอร์ม ในช่องต้นทางเว็บ ให้ระบุ ต้นทางหรือ รหัสส่วนขยาย chrome-extension://YOUR_EXTENSION_ID
4. คลิกลงทะเบียน เพื่อส่งข้อมูล
5. คัดลอกโทเค็นที่ได้รับ แล้วเพิ่มลงในทุกหน้าเว็บที่เข้าร่วมในต้นทางของคุณ หรือใส่ไว้ในไฟล์ Manifest ของส่วนขยาย
   • หากคุณกำลังสร้างส่วนขยาย ให้ทำตามวิธีการช่วงทดลองใช้จากต้นทางของส่วนขยาย
6. เริ่มใช้ Proofreader API

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเริ่มต้นใช้งานการทดลองใช้

ใช้ Proofreader API

หากต้องการตรวจสอบว่าโมเดลพร้อมใช้งานหรือไม่ ให้เรียกใช้ Proofreader.availability() หาก การตอบกลับ availability() เป็น "downloadable" ให้ตรวจสอบความคืบหน้าในการดาวน์โหลด และแจ้งให้ผู้ใช้ทราบ เนื่องจากอาจใช้เวลาสักครู่ในการดาวน์โหลด

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

หากต้องการทริกเกอร์การดาวน์โหลดและสร้างอินสแตนซ์ของ Proofreader ให้ตรวจสอบการเปิดใช้งานของผู้ใช้ จากนั้นเรียกใช้ฟังก์ชัน Proofreader.create() แบบไม่พร้อมกัน

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

สร้างออบเจ็กต์ Proofreader

หากต้องการสร้าง Proofreader ให้ใช้ฟังก์ชัน Proofreader.create()

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

เมธอด create() มีตัวเลือกดังต่อไปนี้

• expectedInputLanguages: อาร์เรย์ของภาษาอินพุตที่คาดไว้

ระบบไม่รองรับตัวเลือก includeCorrectionTypes และ includeCorrectionExplanation จาก วิดีโออธิบาย

เริ่มพิสูจน์อักษรข้อความของผู้ใช้

เรียกใช้ proofread() เพื่อรับการแก้ไขข้อความอินพุต

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

การแก้ไขเป็น ProofreadResult ประเภทหนึ่ง ค้นหาอินพุตที่แก้ไขแล้วทั้งหมดในแอตทริบิวต์ correctedInput และรายการการแก้ไขในอาร์เรย์ 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);
}

นโยบายสิทธิ์, iframe และ Web Worker

โดยค่าเริ่มต้น Proofreader API จะพร้อมใช้งานสำหรับหน้าต่างระดับบนสุดและ iframe ที่มีต้นทางเดียวกันเท่านั้น คุณสามารถมอบสิทธิ์เข้าถึง API ให้กับ iframe ที่มีต้นทางข้ามได้โดยใช้แอตทริบิวต์ allow="" ของนโยบายสิทธิ์

<!--
  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 ไม่พร้อมใช้งานใน Web Worker เนื่องจากความซับซ้อนในการสร้างเอกสารที่รับผิดชอบสำหรับ Worker แต่ละรายการเพื่อตรวจสอบสถานะนโยบายสิทธิ์

สาธิต

ลองใช้เพลย์กราวด์ของ Proofreader API และดู ซอร์สโค้ด

มีส่วนร่วมและแชร์ความคิดเห็น

Proofreader API อยู่ระหว่างการหารืออย่างต่อเนื่องและอาจมีการเปลี่ยนแปลงในอนาคต หากคุณลองใช้ API นี้และมีความคิดเห็น โปรดแจ้งให้เราทราบ

• อ่านคำอธิบาย, ถามคำถาม และเข้าร่วมการสนทนา
• ดูการติดตั้งใช้งานสำหรับ Chrome ใน สถานะ Chrome
• อ่านจุดยืนด้านมาตรฐานของ Mozilla และจุดยืนด้านมาตรฐานของ WebKit
• เข้าร่วมโปรแกรมทดลองใช้ก่อนเปิดตัว เพื่อดู API ใหม่ก่อนใครและรับสิทธิ์เข้าถึงรายชื่ออีเมลของเรา
• หากมีความคิดเห็นเกี่ยวกับการติดตั้งใช้งานของ Chrome โปรดรายงานข้อบกพร่อง Chromium

ค้นพบ AI API ในตัวทั้งหมดที่ใช้โมเดล ซึ่งรวมถึงโมเดลภาษาขนาดใหญ่ในเบราว์เซอร์