Die Proofreader API

Thomas Steiner

Alexandra Klepper

Veröffentlicht am 12. September 2025

Erklärung	Web	Erweiterungen	Chrome-Status	Absicht
GitHub	Ursprungstest	Ursprungstest	Ansicht	Absicht zum Experimentieren

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

Mit der Proofreader API können Sie Ihrer Web anwendung 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.

Wichtig: Gemini Nano ist ein generatives KI-Modell. Bevor Sie APIs verwenden, die Gemini Nano nutzen, sollten Sie den Leitfaden „People + AI Guidebook“ lesen. Dort finden Sie Best Practices, Methoden und Beispiele für das Design mit KI.

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.

Ist Ihr Anwendungsfall nicht dabei? 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.

Hardwareanforderungen prüfen

Die folgenden Anforderungen gelten für Entwickler und Nutzer, die diese APIs in Chrome verwenden. Bei anderen Browsern gelten möglicherweise andere Betriebsanforderungen.

Die Language Detector API und die Translator API funktionieren in Chrome auf dem Desktop. Auf Mobilgeräten funktionieren diese APIs nicht.

Die Prompt API, Summarizer API, Writer API, Rewriter API und Proofreader API funktionieren in Chrome, wenn die folgenden Bedingungen erfüllt sind:

• Betriebssystem: Windows 10 oder 11, macOS 13 oder höher (Ventura und höher), Linux oder ChromeOS (ab Plattform 16389.0.0) auf Chromebook Plus-Geräten. Chrome für Android, iOS und ChromeOS auf Geräten, die keine Chromebook Plus-Geräte sind, wird von den APIs, die Gemini Nano verwenden, noch nicht unterstützt von den APIs, die Gemini Nano verwenden.
• Speicher: Mindestens 22 GB freier Speicherplatz auf dem Volume, das Ihr Chrome-Profil enthält.
  Integrierte Modelle sollten deutlich kleiner sein. Die genaue Größe kann sich mit Updates leicht ändern.
• GPU oder CPU: Integrierte Modelle können mit GPU oder CPU ausgeführt werden.
  • GPU: Mehr als 4 GB VRAM.
  • CPU: Mindestens 16 GB RAM und mindestens 4 CPU-Kerne.
• Netzwerk: Unbegrenzte Daten oder eine nicht getaktete Verbindung.
  Wichtiger Begriff: Eine getaktete Verbindung ist eine Internetverbindung mit begrenztem Datenvolumen. WLAN- und Ethernet-Verbindungen sind in der Regel nicht getaktet, während Mobilfunkverbindungen oft getaktet sind.
  Hinweis: Die Netzwerkanforderung gilt nur für den ersten Download des Modells. Für die spätere Verwendung des Modells ist keine Netzwerkverbindung erforderlich. Bei der Verwendung des Modells werden keine Daten an Google oder Dritte gesendet.

Die genaue Größe von Gemini Nano kann variieren, da das Modell vom Browser aktualisiert wird. Die aktuelle Größe finden Sie unter chrome://on-device-internals.

Hinweis: Wenn der verfügbare Speicherplatz nach dem Download auf weniger als 10 GB sinkt, wird das Modell von Ihrem Gerät entfernt. Das Modell wird noch einmal heruntergeladen sobald die Anforderungen erfüllt sind.

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 zur unzulässigen Nutzung von 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 zum Senden auf Registrieren.
5. Kopieren Sie das bereitgestellte Token und fügen Sie es auf jeder teilnehmenden Webseite in Ihrem Ursprung ein 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);

Tipp: Mit dem npm-Paket @types/dom-chromium-ai können Sie TypeScript-Typdefinitionen für die Prompt API und andere integrierte KI-APIs abrufen, um einfacher auf Ihren Code zuzugreifen.

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 Proofreader.create() Funktion 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 Proofreader.create() Funktion, 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 create() Methode enthält die folgenden Optionen:

• expectedInputLanguages: Ein Array mit 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 in dem correctedInput Attribut und die Liste der Korrekturen in dem 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);
}

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 Standards-Position von Mozilla und die Standards-Position von WebKit.
• 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, melden Sie einen Fehler in Chromium.

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