Proofreader API

Thomas Steiner

Alexandra Klepper

เผยแพร่: 4 กันยายน 2025

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

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

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

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

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

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

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

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

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

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

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

หากต้องการเข้าถึง Proofreader API ใน localhost ระหว่างช่วงทดลองใช้จากต้นทาง คุณต้องอัปเดต Chrome เป็นเวอร์ชันล่าสุด จากนั้น ดำเนินการตามขั้นตอนเหล่านี้:

1. ไปที่ chrome://flags/#proofreader-api-for-gemini-nano
2. เลือกเปิดใช้
3. คลิกเปิดอีกครั้งหรือรีสตาร์ท Chrome

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

หากต้องการเริ่มใช้ 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.create()

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

สร้างออบเจ็กต์ 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ประเภทหนึ่ง ค้นหาอินพุตที่แก้ไขแล้วทั้งหมดในแอตทริบิวต์ corrected และรายการการแก้ไขในอาร์เรย์ 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 ข้ามต้นทางได้โดยใช้แอตทริบิวต์ Permission Policy 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 เนื่องจาก ความซับซ้อนของการจัดทำเอกสารที่รับผิดชอบสำหรับผู้ปฏิบัติงานแต่ละราย เพื่อ ตรวจสอบสถานะนโยบายสิทธิ์

สาธิต

ลองใช้ สนามทดสอบ Proofreader API

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

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

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

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