De Proofreader API

Thomas Steiner

Alexandra Klepper

Gepubliceerd: 12 september 2025

Uitleg	Web	Uitbreidingen	Chrome-status	Intentie
GitHub	Oorsprongsproef	Oorsprongsproef	Weergave	Voornemen om te experimenteren

Tekstcorrectie is het proces waarbij grammaticale, spelling- en interpunctiefouten worden opgespoord en gecorrigeerd. Browsers en besturingssystemen bieden steeds vaker een correctiefunctie aan in hun tekstverwerkingsprogramma's, zoals bijvoorbeeld in Google Docs .

Met de Proofreader API kunt u interactieve proeflezing toevoegen aan uw webapplicatie of -extensie, met ingebouwde AI. Deze API biedt de volgende functies:

• Correctie : Corrigeer de gebruikersinvoer op grammatica, spelling en interpunctie.
• Labels : Label elke correctie met het type fout.
• Uitleg : Een eenvoudige omschrijving van de fout of de reden waarom de correctie noodzakelijk was.

Belangrijk : Gemini Nano is een generatief AI-model. Voordat u API's gebruikt die Gemini Nano inzetten, dient u de handleiding 'People + AI' te raadplegen voor best practices, methoden en voorbeelden voor het ontwerpen met AI.

Gebruiksvoorbeelden

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

• Suggesties voor correcties op forumberichten, reacties op artikelen en e-mails kunnen worden ingediend voordat het bericht wordt geplaatst.
• Geef correcties tijdens het actief maken van aantekeningen.

Staat jouw gebruiksscenario er niet bij? Doe mee aan het early preview-programma en deel je feedback.

Aan de slag

Doe mee aan de Proofreader API origin-proef, die draait in Chrome 141 tot en met 145.

Bekijk de hardwarevereisten.

De volgende vereisten gelden voor ontwikkelaars en gebruikers die functies gebruiken die deze API's in Chrome inzetten. Andere browsers kunnen andere vereisten hebben.

De API's voor taaldetectie en -vertaling werken in Chrome op desktops. Deze API's werken niet op mobiele apparaten.

De Prompt API , Summarizer API , Writer API , Rewriter API en Proofreader API werken in Chrome wanneer aan de volgende voorwaarden wordt voldaan:

• Besturingssysteem : Windows 10 of 11; macOS 13+ (Ventura en nieuwer); Linux; of ChromeOS (vanaf platform 16389.0.0 en nieuwer) op Chromebook Plus- apparaten. Chrome voor Android, iOS en ChromeOS op niet-Chromebook Plus-apparaten wordt nog niet ondersteund door de API's die gebruikmaken van Gemini Nano.
• Opslag : Minimaal 22 GB vrije ruimte op het volume waarop uw Chrome-profiel staat.
  De ingebouwde modellen zouden aanzienlijk kleiner moeten zijn. De exacte afmetingen kunnen na updates iets afwijken.
• GPU of CPU : Ingebouwde modellen kunnen met een GPU of een CPU werken.
  • GPU : Strikt meer dan 4 GB VRAM.
  • CPU : 16 GB RAM of meer en 4 processorkernen of meer.
• Netwerk : Onbeperkte data of een verbinding zonder datalimiet.
  Kernbegrip : Een verbinding met datalimiet is een internetverbinding met een datalimiet. Wi-Fi- en ethernetverbindingen zijn standaard meestal onbeperkt, terwijl mobiele verbindingen vaak wel een datalimiet hebben.
  Let op : een netwerkverbinding is alleen vereist voor het eerste downloaden van het model. Voor later gebruik van het model is geen netwerkverbinding nodig. Er worden geen gegevens naar Google of derden verzonden tijdens het gebruik van het model.

De exacte afmetingen van de Gemini Nano kunnen variëren, afhankelijk van de browserupdate van het model. Ga naar chrome://on-device-internals om de huidige afmetingen te achterhalen.

Let op : als de beschikbare opslagruimte na het downloaden minder dan 10 GB bedraagt, wordt het model van uw apparaat verwijderd. Het model wordt opnieuw gedownload zodra aan de vereisten is voldaan.

Voeg ondersteuning toe voor localhost

Alle ingebouwde AI-API's zijn beschikbaar op localhost in Chrome. Stel de volgende vlaggen in op 'Ingeschakeld' :

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

Klik vervolgens op Opnieuw starten of herstart Chrome. Als je fouten tegenkomt, los dan de problemen met localhost op .

Meld je aan voor de Origin-proef.

Om de Proofreader API te gaan gebruiken, volg je deze stappen:

1. Neem kennis van 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 je inzending in te dienen, klik je op Registreren .
5. Kopieer het verstrekte token en voeg het toe aan elke deelnemende webpagina op uw server of neem het op in uw extensiemanifest.
   • Als je een extensie bouwt, volg dan de instructies voor de Origin-proefversie van de extensies.
6. Begin met het gebruik van de Proofreader API.

Lees meer over hoe u kunt beginnen met Origin-onderzoeken .

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" is, luistert u naar de voortgang van de download en informeert u de gebruiker, aangezien de download enige tijd kan duren.

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

Tip: Gebruik het npm-pakket @types/dom-chromium-ai om TypeScript-typings te verkrijgen voor de Prompt API en andere ingebouwde AI API's, zodat u deze gemakkelijker in uw code kunt gebruiken.

Om de download te starten en de proeflezer te initialiseren, controleer je 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,
});

Maak een Proofreader-object aan.

Om een ​​proeflezer te maken, gebruikt u de functie Proofreader.create() .

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 array met de verwachte invoertalen.

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

Begin met het proeflezen van gebruikersteksten

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

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

Correcties zijn een type ProofreadResult . De volledig gecorrigeerde invoer vindt u in het attribuut correctedInput 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 hun iframes van dezelfde oorsprong. Toegang tot de API kan worden gedelegeerd aan iframes van een andere oorsprong met behulp van het attribuut "allow="" in het machtigingsbeleid.

<!--
  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 opzetten van een verantwoordelijk document voor elke worker, om de status van het machtigingsbeleid te controleren.

Demo

Experimenteer met de Proofreader API-playground en bekijk de broncode .

Betrek de deelnemers en deel je feedback.

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

• Lees de toelichting , 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 je aan voor het early preview-programma en krijg als eerste toegang tot nieuwe API's en onze mailinglijst.
• Als je feedback hebt over de implementatie in Chrome, meld dit dan via een Chromium-bugrapport .

Ontdek alle ingebouwde AI API's die gebruikmaken van modellen, waaronder grote taalmodellen, in de browser.