Interfejs Proofreader API

Thomas Steiner

Alexandra Klepper

Opublikowano: 12 września 2025 r.

Wyjaśnienie	Sieć	Rozszerzenia	Stan Chrome	Intencja
GitHub	Okres próbny dla deweloperów	Okres próbny dla deweloperów	Wyświetl	Zamiar przeprowadzenia eksperymentu

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: proste wyjaśnienie, na czym polega błąd lub dlaczego konieczna była poprawka.

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 opublikowaniem posta;
• wprowadzać poprawki 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 testowania origin interfejsu Proofreader API, które jest dostępne w Chrome w wersjach od 141 do 145.

Dodawanie obsługi hosta lokalnego

Wszystkie wbudowane interfejsy API AI są dostępne w localhost w Chrome. Ustaw te flagi na Włączone:

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

Następnie kliknij Uruchom ponownie lub ponownie uruchom Chrome. Jeśli wystąpią błędy, rozwiąż problemy z localhostem.

Rejestracja w okresie testowania origin

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 (Origin strony) podaj origin strony 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 origin 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 są rodzajem ProofreadResult. W pełni poprawione dane wejściowe znajdziesz w atrybucie correctedInput, 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 oknach najwyższego poziomu i w ramkach iframe z tej samej domeny. Dostęp do interfejsu API można przekazać do ramek 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 zgodności z zasadami dotyczącymi uprawnień.

Prezentacja

Wypróbuj plac zabaw interfejsu Proofreader API i zapoznaj się z kodem źródłowym.

Zaangażuj się i prześlij opinię

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.

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