Interfejs Proofreader API

Thomas Steiner

Alexandra Klepper

Opublikowano: 4 września 2025 r.

Wyjaśnienie	Sieć	Rozszerzenia	Stan Chrome	Intencja
GitHub	Wersja próbna origin	Wersja próbna origin	Wyświetl	Zamiar utworzenia prototypu

Korekta to proces wyszukiwania i poprawiania błędów gramatycznych, ortograficznych i interpunkcyjnych. Przeglądarki i systemy operacyjne coraz częściej oferują korektę w swoich narzędziach do pisania, np. w Dokumentach Google.

Interfejs Proofreader API umożliwia udostępnianie interaktywnej korekty w aplikacji lub rozszerzeniu internetowym dzięki wbudowanej AI. Ten interfejs API oferuje te funkcje:

• Poprawianie: poprawianie wprowadzonych przez użytkownika danych pod względem gramatyki, ortografii i interpunkcji.
• Etykiety: oznacz każdą poprawkę etykietą z typem błędu.
• Wyjaśnienie: zdefiniowanie błędu lub wyjaśnienie, dlaczego konieczna była poprawka, w prosty sposób.

Przypadki użycia

Istnieje wiele powodów, dla których warto korzystać z interfejsu Proofreader API. Oto kilka przykładów:

• sugerować poprawki w wiadomościach na forum, komentarzach do artykułów i e-mailach przed przesłaniem posta;
• korygowanie błędów podczas aktywnego robienia notatek;

Nie widzisz swojego przypadku użycia? Dołącz do programu wcześniejszego dostępu, aby podzielić się swoją opinią.

Rozpocznij

Dołącz do wersji próbnej interfejsu Proofreader API, która będzie działać w Chrome w wersjach od 141 do 145.

Dodawanie obsługi hosta lokalnego

Aby uzyskać dostęp do interfejsu Proofreader API na hoście lokalnym podczas wersji próbnej origin, musisz zaktualizować Chrome do najnowszej wersji. Następnie wykonaj poniższe czynności:

1. Jedź do: chrome://flags/#proofreader-api-for-gemini-nano.
2. Kliknij Włączono.
3. Kliknij Uruchom ponownie lub uruchom ponownie Chrome.

Rejestracja w okresie próbnym

Aby zacząć korzystać z interfejsu Proofreader API, wykonaj te czynności:

1. Potwierdź znajomość zasad Google dotyczących niedozwolonych zastosowań generatywnej AI.
2. Otwórz testowanie origin interfejsu Proofreader API.
3. Kliknij Zarejestruj się i wypełnij formularz. W polu Web origin (Pochodzenie w internecie) podaj pochodzenie lub identyfikator rozszerzenia: chrome-extension://YOUR_EXTENSION_ID.
4. Aby przesłać zgłoszenie, kliknij Zarejestruj.
5. Skopiuj podany token i dodaj go do każdej uczestniczącej w programie strony internetowej w swojej domenie lub umieść go w pliku manifestu rozszerzenia.
   • Jeśli tworzysz rozszerzenie, postępuj zgodnie z instrukcjami dotyczącymi testowania pochodzenia rozszerzeń.
6. Zacznij korzystać z interfejsu Proofreader API.

Dowiedz się więcej o tym, jak zacząć korzystać z okresów próbnych.

Korzystanie z interfejsu Proofreader API

Aby sprawdzić, czy model jest gotowy do użycia, wywołaj funkcję Proofreader.availability(). Jeśli odpowiedź na availability() to "downloadable", śledź postęp pobierania i informuj o nim użytkownika, ponieważ pobieranie może zająć trochę czasu.

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

Aby uruchomić pobieranie i utworzyć instancję korektora, sprawdź aktywację użytkownika. Następnie wywołaj asynchroniczną funkcję Proofreader.create().

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

Tworzenie obiektu Proofreader

Aby utworzyć korektora, użyj funkcji Proofreader.create().

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

Metoda create() obejmuje te opcje:

• expectedInputLanguages: tablica oczekiwanych języków wejściowych.

Opcje includeCorrectionTypes i includeCorrectionExplanation z wyjaśnienia nie są obsługiwane.

Rozpocznij korektę tekstu użytkownika

Wywołaj funkcję proofread(), aby uzyskać poprawki do wpisanego tekstu:

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

Korekty to rodzaj ProofreadResult. W pełni poprawione dane wejściowe znajdziesz w atrybucie corrected, a listę poprawek w tablicy 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);
}

Zasady dotyczące uprawnień, elementy iframe i skrypty Web Worker

Domyślnie interfejs Proofreader API jest dostępny tylko w przypadku okien najwyższego poziomu i pochodzących z tej samej domeny elementów iframe. Dostęp do interfejsu API można przekazać ramkom iframe z innych domen za pomocą atrybutu 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>

Interfejs Proofreader API jest niedostępny w Web Workers. Wynika to ze złożoności tworzenia odpowiedniego dokumentu dla każdego pracownika w celu sprawdzenia stanu zasad dotyczących uprawnień.

Prezentacja

Wypróbuj plac zabaw interfejsu Proofreader API.

Angażowanie się i przesyłanie opinii

Interfejs Proofreader API jest obecnie przedmiotem dyskusji i w przyszłości może ulec zmianie. Jeśli wypróbujesz ten interfejs API i chcesz podzielić się opinią, chętnie ją poznamy.

• Przeczytaj wyjaśnienie, zadaj pytania i weź udział w dyskusji.
• Sprawdź wdrożenie w Chrome na stronie Chrome Status
• Przeczytaj stanowisko Mozilli dotyczące standardów i stanowisko WebKit dotyczące standardów.
• Dołącz do programu wcześniejszego dostępu, aby jako pierwszy(-a) poznać nowe interfejsy API i uzyskać dostęp do naszej listy mailingowej.
• Jeśli masz uwagi na temat implementacji Chrome, zgłoś błąd w Chromium.

Poznaj wszystkie wbudowane interfejsy AI API, które używają modeli, w tym dużych modeli językowych, w przeglądarce.