De Proofreader API

Thomas Steiner

Alexandra Klepper

Gepubliceerd: 12 september 2025

Uitlegger	Web	Uitbreidingen	Chrome-status	Intentie
GitHub	Oorsprongsproef	Oorsprongsproef	Weergave	Intentie om prototype te maken

Correctie is het proces van het zoeken naar en corrigeren van fouten in grammatica, spelling en interpunctie. Browsers en besturingssystemen bieden steeds vaker de mogelijkheid om correcties uit te voeren in hun schrijfprogramma's, zoals Google Docs .

Met de Proofreader API kunt u uw webapplicatie of -extensie interactief proeflezen, met ingebouwde AI. Deze API biedt de volgende functies:

• Correctie : Corrigeer de grammatica, spelling en interpunctie van de gebruikersinvoer.
• Labels : Geef elke correctie een label met het fouttype.
• Uitleg : Geef in begrijpelijke taal aan wat de fout is of waarom correctie nodig was.

Gebruiksscenario's

Er zijn veel redenen waarom u Proofreader API zou willen gebruiken. Bijvoorbeeld:

• Stel correcties voor in forumberichten, reacties op artikelen en e-mails voordat u het bericht verzendt.
• Geef correcties tijdens het actief maken van aantekeningen.

Ontbreekt uw use case? Doe mee aan het early preview-programma en deel uw feedback.

Aan de slag

Doe mee aan de proefversie van de Proofreader API, die beschikbaar is in Chrome 141 tot en met 145.

Ondersteuning toevoegen aan localhost

Om tijdens de proefperiode toegang te krijgen tot de Proofreader API op localhost, moet u Chrome updaten naar de nieuwste versie. Volg vervolgens deze stappen:

1. Ga naar chrome://flags/#proofreader-api-for-gemini-nano .
2. Selecteer Ingeschakeld .
3. Klik op Opnieuw starten of start Chrome opnieuw.

Meld je aan voor de oorsprongsproef

Om de Proofreader API te gebruiken, volgt u deze stappen:

1. Erken het beleid van Google inzake verboden toepassingen van generatieve AI .
2. Ga naar de proefversie van de Proofreader API .
3. Klik op Registreren en vul het formulier in. Geef in het veld Web origin uw origin- of extensie-ID op, chrome-extension://YOUR_EXTENSION_ID .
4. Om te verzenden, klikt u op Registreren .
5. Kopieer het verstrekte token en voeg het toe aan elke deelnemende webpagina op uw oorsprong of neem het op in het manifest van uw extensie.
   • Als u een extensie bouwt, volgt u de instructies voor de proefversie van de extensies.
6. Begin met het gebruiken van de Proofreader API.

Lees meer over hoe u kunt beginnen met oorsprongsproeven .

Gebruik de Proofreader API

Om te bepalen of het model klaar is voor gebruik, roept u Proofreader.availability() aan. Als het antwoord op availability() "downloadable" was, luister dan naar de voortgang van het downloaden en informeer de gebruiker, aangezien het downloaden enige tijd kan duren.

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

Om de download te starten en de proeflezer te instantiëren, controleert u of de gebruiker is geactiveerd . Roep vervolgens de asynchrone functie Proofreader.create() aan.

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

Een Proofreader-object maken

Gebruik de functie Proofreader.create() om een ​​proeflezer te maken.

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

De create() -methode bevat de volgende opties:

• expectedInputLanguages : een reeks verwachte invoertalen.

De opties includeCorrectionTypes en includeCorrectionExplanation van de explainer worden niet ondersteund.

Begin met het proeflezen van de gebruikerstekst

Roep proofread() aan om correcties op te halen voor een invoertekst:

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

Correcties zijn een type ProofreadResult . Zoek de volledig gecorrigeerde invoer in het attribuut corrected en de lijst met correcties in de corrections array:

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);
}

Toestemmingsbeleid, iframes en webworkers

Standaard is de Proofreader API alleen beschikbaar voor vensters op het hoogste niveau en voor iframes met dezelfde oorsprong. Toegang tot de API kan worden gedelegeerd aan iframes met meerdere oorsprongen met behulp van het kenmerk '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>

De Proofreader API is niet beschikbaar in Web Workers. Dit komt door de complexiteit van het aanmaken van een verantwoordelijk document voor elke worker, om zo de status van het machtigingsbeleid te controleren.

Demonstratie

Experimenteer met de Proofreader API-speeltuin .

Betrek en deel feedback

De Proofreader API wordt momenteel actief besproken en kan in de toekomst worden gewijzigd. Als u deze API uitprobeert en feedback heeft, horen we dat graag.

• Lees de uitleg , stel vragen en neem deel aan de discussie.
• Bekijk de implementatie voor Chrome op Chrome Status
• Lees het standpunt van Mozilla Standards en het standpunt van WebKit Standards.
• Meld u aan voor ons early preview-programma om alvast kennis te maken met nieuwe API's en toegang te krijgen tot onze mailinglijst.
• Als u feedback hebt over de implementatie van Chrome, meld dit dan als Chromium-bug .

Ontdek alle ingebouwde AI API's die modellen gebruiken, inclusief grote taalmodellen, in de browser.