API корректора

Thomas Steiner

Alexandra Klepper

Опубликовано: 12 сентября 2025 г.

Объяснитель	Интернет	Расширения	Статус Chrome	Намерение
GitHub	Пробный запуск	Пробный запуск	Вид	Намерение создать прототип

Корректура — это процесс поиска и исправления грамматических, орфографических и пунктуационных ошибок. Браузеры и операционные системы всё чаще предлагают корректуру в своих инструментах для редактирования, например, в Google Docs .

С помощью Proofreader API вы можете реализовать интерактивную корректуру в вашем веб-приложении или расширении с помощью встроенного искусственного интеллекта. Этот API предлагает следующие функции:

• Исправление : исправление грамматики, орфографии и пунктуации, введенных пользователем.
• Метки : обозначьте каждое исправление по типу ошибки.
• Объяснение : простое объяснение ошибки и необходимости ее исправления.

Варианты использования

Существует множество причин, по которым вам может понадобиться Proofreader API, например:

• Предлагайте исправления к сообщениям на форуме, комментариям к статьям и электронным письмам до того, как сообщение будет отправлено.
• Вносите исправления во время активного конспектирования.

Не нашли свой вариант использования? Присоединяйтесь к программе раннего ознакомления и поделитесь своим мнением.

Начать

Присоединяйтесь к пробной версии Proofreader API, работающей в Chrome 141–145.

Добавить поддержку localhost

Чтобы получить доступ к Proofreader API на локальном хосте во время пробного периода, необходимо обновить Chrome до последней версии. Затем выполните следующие действия:

1. Перейдите по адресу chrome://flags/#proofreader-api-for-gemini-nano .
2. Выберите Включено .
3. Нажмите «Перезапустить» или перезапустите Chrome.

Зарегистрируйтесь для участия в пробной версии Origin

Чтобы начать использовать Proofreader API, выполните следующие действия:

1. Ознакомьтесь с Политикой Google в отношении запрещенного использования генеративного ИИ .
2. Перейти к пробной версии Proofreader API .
3. Нажмите «Зарегистрироваться» и заполните форму. В поле «Веб-источник» укажите идентификатор вашего источника или расширения chrome-extension://YOUR_EXTENSION_ID .
4. Чтобы отправить, нажмите кнопку «Зарегистрироваться» .
5. Скопируйте предоставленный токен и добавьте его на каждую участвующую веб-страницу вашего источника или включите его в манифест расширения.
   • Если вы создаете расширение, следуйте инструкциям по использованию пробной версии Extensions Origin.
6. Начните использовать API Proofreader.

Узнайте больше о том, как начать работу с испытаниями Origin .

Используйте 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.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);
}

Политика разрешений, фреймы и веб-работники

По умолчанию API Proofreader доступен только для окон верхнего уровня и для их 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>

API Proofreader недоступно в Web Workers. Это связано со сложностью создания ответственного документа для каждого Worker, необходимого для проверки статуса политики разрешений.

Демо

Поэкспериментируйте с площадкой Proofreader API .

Привлекайте и делитесь отзывами

API корректора находится в стадии активного обсуждения и может быть изменен в будущем. Если вы попробуете этот API и у вас есть отзывы, мы будем рады их услышать.

• Прочитайте пояснение , задайте вопросы и примите участие в обсуждении.
• Проверьте реализацию Chrome на Chrome Status
• Ознакомьтесь с позицией стандартов Mozilla и позицией стандартов WebKit.
• Присоединяйтесь к программе предварительного просмотра, чтобы заранее ознакомиться с новыми API и получить доступ к нашему списку рассылки.
• Если у вас есть отзыв о реализации Chrome, отправьте сообщение об ошибке Chromium .

Откройте для себя все встроенные API ИИ , которые используют модели, включая большие языковые модели, в браузере.