Proofreader API

Thomas Steiner

Alexandra Klepper

Xuất bản: Ngày 4 tháng 9 năm 2025

Video giải thích	Web	Phần mở rộng	Trạng thái của Chrome	Mục đích
GitHub	Bản dùng thử theo nguyên gốc	Bản dùng thử theo nguyên gốc	Xem	Ý định tạo nguyên mẫu

Hiệu đính là quá trình tìm và sửa lỗi ngữ pháp, chính tả và dấu câu. Các trình duyệt và hệ điều hành ngày càng cung cấp tính năng hiệu đính cho các công cụ soạn thảo của mình, chẳng hạn như trong Google Tài liệu.

Với Proofreader API, bạn có thể cung cấp tính năng hiệu đính tương tác cho ứng dụng hoặc tiện ích web của mình, có tích hợp AI. API này cung cấp các chức năng sau:

• Sửa lỗi: Sửa lỗi ngữ pháp, chính tả và dấu câu trong nội dung người dùng nhập.
• Nhãn: Gắn nhãn cho từng nội dung chỉnh sửa theo loại lỗi.
• Giải thích: Định nghĩa lỗi hoặc lý do cần thiết phải sửa lỗi bằng ngôn ngữ đơn giản.

Trường hợp sử dụng

Có nhiều lý do khiến bạn muốn sử dụng Proofreader API. Ví dụ:

• Đề xuất nội dung chỉnh sửa cho tin nhắn trên diễn đàn, bình luận về bài viết và email, trước khi bài đăng được gửi.
• Đưa ra nội dung chỉnh sửa trong khi ghi chú.

Bạn có thấy trường hợp sử dụng của mình không? Tham gia chương trình dùng thử sớm để chia sẻ ý kiến phản hồi của bạn.

Bắt đầu

Tham gia bản dùng thử theo nguyên gốc của Proofreader API, chạy trong Chrome 141 đến 145.

Thêm hỗ trợ cho localhost

Để truy cập vào Proofreader API trên localhost trong thời gian dùng thử theo nguyên gốc, bạn phải cập nhật Chrome lên phiên bản mới nhất. Sau đó, thực hiện theo những bước sau:

1. Chuyển đến chrome://flags/#proofreader-api-for-gemini-nano.
2. Chọn Bật.
3. Nhấp vào Chạy lại hoặc khởi động lại Chrome.

Đăng ký dùng thử nguồn gốc

Để bắt đầu sử dụng Proofreader API, hãy làm theo các bước sau:

1. Xác nhận Chính sách về các hành vi bị cấm khi sử dụng AI tạo sinh của Google.
2. Chuyển đến bản dùng thử theo nguyên gốc Proofreader API.
3. Nhấp vào Đăng ký rồi điền thông tin vào biểu mẫu. Trong trường Nguồn gốc trang web, hãy cung cấp nguồn gốc hoặc mã nhận dạng tiện ích của bạn, chrome-extension://YOUR_EXTENSION_ID.
4. Để gửi, hãy nhấp vào Đăng ký.
5. Sao chép mã thông báo được cung cấp và thêm mã thông báo đó vào mọi trang web tham gia trên nguồn gốc của bạn hoặc đưa mã thông báo đó vào tệp kê khai Tiện ích.
   • Nếu bạn đang tạo một Tiện ích, hãy làm theo hướng dẫn về giai đoạn dùng thử ban đầu của Tiện ích
6. Bắt đầu sử dụng Proofreader API.

Tìm hiểu thêm về cách bắt đầu sử dụng các thử nghiệm nguồn gốc.

Sử dụng Proofreader API

Để xác định xem mô hình đã sẵn sàng sử dụng hay chưa, hãy gọi Proofreader.availability(). Nếu phản hồi cho availability() là "downloadable", hãy theo dõi tiến trình tải xuống và thông báo cho người dùng, vì quá trình tải xuống có thể mất thời gian.

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

Để kích hoạt quá trình tải xuống và khởi tạo trình hiệu đính, hãy kiểm tra hoạt động kích hoạt của người dùng. Sau đó, hãy gọi hàm không đồng bộ Proofreader.create().

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

Tạo đối tượng Proofreader

Để tạo một Trình hiệu đính, hãy dùng hàm Proofreader.create().

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

Phương thức create() bao gồm các lựa chọn sau:

• expectedInputLanguages: Một mảng các ngôn ngữ nhập dự kiến.

Không hỗ trợ các lựa chọn includeCorrectionTypes và includeCorrectionExplanation trong phần giải thích.

Bắt đầu hiệu đính văn bản của người dùng

Gọi proofread() để nhận nội dung hiệu đính cho văn bản đầu vào:

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

Mức điều chỉnh là một loại ProofreadResult. Tìm dữ liệu đầu vào đã được sửa hoàn toàn trong thuộc tính corrected và danh sách các nội dung sửa trong mảng 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);
}

Chính sách về quyền, iframe và Web Worker

Theo mặc định, Proofreader API chỉ có sẵn cho các cửa sổ cấp cao nhất và các iframe có cùng nguồn gốc. Bạn có thể uỷ quyền truy cập vào API cho các iframe trên nhiều nguồn gốc bằng cách sử dụng thuộc tính allow="" của Chính sách về quyền:

<!--
  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 không có trong Web Workers. Điều này là do sự phức tạp của việc thiết lập một tài liệu có trách nhiệm cho mỗi worker, nhằm kiểm tra trạng thái Chính sách về quyền.

Bản minh hoạ

Khám phá sân chơi Proofreader API.

Tương tác và chia sẻ ý kiến phản hồi

Proofreader API đang được thảo luận tích cực và có thể thay đổi trong tương lai. Nếu bạn dùng thử API này và có ý kiến phản hồi, chúng tôi rất mong nhận được ý kiến của bạn.

• Đọc nội dung giải thích, đặt câu hỏi và tham gia thảo luận.
• Xem xét việc triển khai cho Chrome trên Trạng thái của Chrome
• Đọc quan điểm của Mozilla về các tiêu chuẩn và quan điểm của WebKit về các tiêu chuẩn.
• Tham gia chương trình xem trước sớm để xem trước các API mới và truy cập vào danh sách gửi thư của chúng tôi.
• Nếu bạn có ý kiến phản hồi về cách Chrome triển khai, hãy báo cáo lỗi Chromium.

Khám phá tất cả các API AI tích hợp sẵn sử dụng các mô hình (bao gồm cả mô hình ngôn ngữ lớn) trong trình duyệt.