Die Proofreader API

Thomas Steiner

Alexandra Klepper

Veröffentlicht am 12. September 2025

Erklärung	Web	Erweiterungen	Chrome-Status	Intent
GitHub	Testzeitraum für Entwickler	Testzeitraum für Entwickler	Ansicht	Absicht zum Testen

Beim Korrekturlesen werden Fehler in Grammatik, Rechtschreibung und Zeichensetzung gesucht und korrigiert. Browser und Betriebssysteme bieten diese Funktion zunehmend in ihren Tools zur Texterstellung an, z. B. in Google Docs.

Mit der Proofreader API können Sie Ihrer Webanwendung oder ‑erweiterung eine interaktive Korrekturlesefunktion mit integrierter KI hinzufügen. Diese API bietet die folgenden Funktionen:

• Korrektur: Korrigiert Nutzereingaben in Bezug auf Grammatik, Rechtschreibung und Zeichensetzung.
• Labels: Kennzeichnet jede Korrektur mit dem Fehlertyp.
• Erklärung: Erklärt in einfacher Sprache, was der Fehler ist oder warum die Korrektur notwendig war.

Anwendungsfälle

Es gibt viele Gründe, die Proofreader API zu verwenden, z. B.:

• Korrekturen für Forumsbeiträge, Kommentare zu Artikeln und E-Mails vorschlagen, bevor der Beitrag gesendet wird.
• Korrekturen während der aktiven Notizenerstellung anbieten.

Fehlt Ihr Anwendungsfall? Nehmen Sie am Early-Access-Programm teil und geben Sie uns Feedback.

Jetzt starten

Nehmen Sie am Ursprungstest für die Proofreader API teil, der in Chrome 141 bis 145 läuft.

Unterstützung für „localhost“ hinzufügen

Alle integrierten KI-APIs sind in Chrome unter localhost verfügbar. Legen Sie die folgenden Flags auf Aktiviert fest:

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

Klicken Sie dann auf Neu starten oder starten Sie Chrome neu. Wenn Fehler auftreten, beheben Sie Probleme mit „localhost“.

Für den Ursprungstest registrieren

So verwenden Sie die Proofreader API:

1. Bestätigen Sie die Richtlinie zu verbotenen Verwendungsweisen generativer KI von Google.
2. Rufen Sie den Ursprungstest für die Proofreader API auf.
3. Klicken Sie auf Registrieren und füllen Sie das Formular aus. Geben Sie im Feld „Web-Ursprung“ Ihren Ursprung oder Ihre Erweiterungs-ID an: chrome-extension://YOUR_EXTENSION_ID.
4. Klicken Sie auf Registrieren, um die Registrierung abzuschließen.
5. Kopieren Sie das bereitgestellte Token und fügen Sie es auf jeder teilnehmenden Webseite Ihres Ursprungs hinzu oder fügen Sie es in das Manifest Ihrer Erweiterung ein.
   • Wenn Sie eine Erweiterung erstellen, folgen Sie der Anleitung für den Ursprungstest für Erweiterungen.
6. Verwenden Sie die Proofreader API.

Weitere Informationen zum Einstieg in Ursprungstests.

Proofreader API verwenden

Rufen Sie Proofreader.availability() auf, um zu prüfen, ob das Modell einsatzbereit ist. Wenn die Antwort auf availability() "downloadable" lautet, beobachten Sie den Downloadfortschritt und informieren Sie den Nutzer, da der Download einige Zeit dauern kann.

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

Prüfen Sie, ob der Nutzer die Funktion aktiviert hat, um den Download auszulösen und die Korrekturlesefunktion zu instanziieren. Rufen Sie dann die asynchrone Funktion Proofreader.create() auf.

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

Proofreader-Objekt erstellen

Verwenden Sie die Funktion Proofreader.create(), um eine Korrekturlesefunktion zu erstellen.

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

Die Methode create() enthält die folgenden Optionen:

• expectedInputLanguages: Ein Array der erwarteten Eingabesprachen.

Die Optionen includeCorrectionTypes und includeCorrectionExplanation aus der Erklärung werden nicht unterstützt.

Korrekturlesen von Nutzertext starten

Rufen Sie proofread() auf, um Korrekturen für einen Eingabetext zu erhalten:

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

Korrekturen sind ein Typ von ProofreadResult. Die vollständig korrigierte Eingabe finden Sie im Attribut correctedInput und die Liste der Korrekturen im Array 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);
}

Berechtigungsrichtlinie, iFrames und Web Worker

Standardmäßig ist die Proofreader API nur für Fenster der obersten Ebene und für iFrames mit demselben Ursprung verfügbar. Der Zugriff auf die API kann mithilfe des Attributs allow="" der Berechtigungsrichtlinie an ursprungsübergreifende iFrames delegiert werden:

<!--
  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>

Die Proofreader API ist in Web Workern nicht verfügbar. Das liegt daran, dass es komplex ist, für jeden Worker ein verantwortliches Dokument zu erstellen, um den Status der Berechtigungsrichtlinie zu prüfen.

Demo

Probieren Sie die Proofreader API-Sandbox aus und sehen Sie sich den Quellcode an.

Mitmachen und Feedback geben

Die Proofreader API wird aktiv diskutiert und kann sich in Zukunft ändern. Wenn Sie diese API ausprobieren und Feedback haben, freuen wir uns darauf.

• Lesen Sie die Erklärung, stellen Sie Fragen und beteiligen Sie sich an der Diskussion.
• Sehen Sie sich die Implementierung für Chrome im Chrome-Status an.
• Lesen Sie die Mozilla Standards Position und die WebKit Standards Position.
• Nehmen Sie am Early-Access-Programm teil um neue APIs vorab zu sehen und Zugriff auf unsere Mailingliste zu erhalten.
• Wenn Sie Feedback zur Implementierung von Chrome haben, erstellen Sie in Chromium einen Eintrag für das Problem.

Entdecken Sie alle der integrierten KI-APIs, die Modelle, einschließlich Large Language Models, im Browser verwenden.