API Proofreader

Thomas Steiner

Alexandra Klepper

Data di pubblicazione: 4 settembre 2025

Spiegazione	Web	Estensioni	Stato di Chrome	Intenzione
GitHub	Origin trial	Origin trial	Visualizza	Intent to Prototype

La correzione bozza è il processo di ricerca e correzione di errori di grammatica, ortografia e punteggiatura. I browser e i sistemi operativi offrono sempre più la correzione bozze ai loro strumenti di composizione, ad esempio in Documenti Google.

Con l'API Proofreader, puoi fornire la correzione interattiva alla tua applicazione web o estensione, con l'AI integrata. Questa API offre le seguenti funzioni:

• Correzione: correggi gli input dell'utente per grammatica, ortografia e punteggiatura.
• Etichette: etichetta ogni correzione in base al tipo di errore.
• Spiegazione: definisci l'errore o il motivo per cui la correzione è stata necessaria in un linguaggio semplice.

Casi d'uso

Esistono molti motivi per cui potresti voler utilizzare l'API Proofreader. Ad esempio:

• Suggerisci correzioni a messaggi del forum, commenti su articoli ed email, prima dell'invio del post.
• Fornisci correzioni durante la creazione attiva di note.

Il tuo caso d'uso non è presente? Partecipa al programma di anteprima per condividere il tuo feedback.

Inizia

Partecipa alla prova dell'origine dell'API Proofreader, in esecuzione in Chrome 141-145.

Aggiungere il supporto a localhost

Per accedere all'API Proofreader su localhost durante la prova dell'origine, devi aggiornare Chrome all'ultima versione. A tale scopo, procedi nel seguente modo:

1. Vai a chrome://flags/#proofreader-api-for-gemini-nano.
2. Seleziona Attivata.
3. Fai clic su Riavvia o riavvia Chrome.

Registrati alla prova dell'origine

Per iniziare a utilizzare l'API Proofreader, segui questi passaggi:

1. Accetta le Norme relative all'uso vietato dell'AI generativa di Google.
2. Vai alla prova dell'origine dell'API Proofreader.
3. Fai clic su Registrati e compila il modulo. Nel campo Origine web, fornisci la tua origine o l'ID estensione, chrome-extension://YOUR_EXTENSION_ID.
4. Per inviare, fai clic su Registra.
5. Copia il token fornito e aggiungilo a ogni pagina web partecipante nell'origine o includilo nel file manifest dell'estensione.
   • Se stai creando un'estensione, segui le istruzioni per la prova dell'origine delle estensioni.
6. Inizia a utilizzare l'API Proofreader.

Scopri di più su come iniziare a utilizzare le prove di origine.

Utilizzare l'API Proofreader

Per determinare se il modello è pronto per l'uso, chiama Proofreader.availability(). Se la risposta a availability() è "downloadable", ascolta l'avanzamento del download e informa l'utente, poiché il download potrebbe richiedere tempo.

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

Per attivare il download e creare il correttore, verifica l'attivazione utente. Quindi, chiama la funzione asincrona Proofreader.create().

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

Crea un oggetto Proofreader

Per creare un Proofreader, utilizza la funzione Proofreader.create().

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

Il metodo create() include le seguenti opzioni:

• expectedInputLanguages: un array di lingue di input previste.

Le opzioni includeCorrectionTypes e includeCorrectionExplanation della spiegazione non sono supportate.

Inizia a correggere il testo dell'utente

Chiama proofread() per ricevere correzioni per un testo inserito:

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

Le correzioni sono un tipo di ProofreadResult. Trova l'input completamente corretto nell'attributo corrected e l'elenco delle correzioni nell'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);
}

Norme relative alle autorizzazioni, iframe e web worker

Per impostazione predefinita, l'API Proofreader è disponibile solo per le finestre di primo livello e per i relativi iframe della stessa origine. L'accesso all'API può essere delegato agli iframe cross-origin utilizzando l'attributo 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>

L'API Proofreader non è disponibile nei web worker. Ciò è dovuto alla complessità di stabilire un documento responsabile per ogni lavoratore, al fine di controllare lo stato del criterio delle autorizzazioni.

Demo

Prova l'area giochi dell'API Proofreader.

Partecipare e condividere feedback

L'API Proofreader è in fase di discussione e soggetta a modifiche in futuro. Se provi questa API e hai un feedback, ci farebbe piacere riceverlo.

• Leggi la spiegazione, poni domande e partecipa alla discussione.
• Esamina l'implementazione per Chrome su Chrome Status
• Leggi la posizione di Mozilla Standards e di WebKit Standards.
• Partecipa al programma di anteprima per dare un'occhiata in anteprima alle nuove API e accedere alla nostra mailing list.
• Se hai feedback sull'implementazione di Chrome, segnala un bug di Chromium.

Scopri tutte le API AI integrate che utilizzano modelli, inclusi i modelli linguistici di grandi dimensioni, nel browser.