API Proofreader

Thomas Steiner

Alexandra Klepper

Publié le 12 septembre 2025

Présentateur	Web	Extensions	État de Chrome	Intention
GitHub	Essai pour les développeurs	Essai pour les développeurs	Afficher	Intention de tester

La relecture consiste à rechercher et à corriger les erreurs de grammaire, d'orthographe et de ponctuation. Les navigateurs et les systèmes d'exploitation proposent de plus en plus la relecture à leurs outils de composition, comme dans Google Docs.

Avec l'API Proofreader, vous pouvez fournir une relecture interactive à votre application ou extension Web, avec une IA intégrée. Cette API offre les fonctions suivantes :

• Correction : corrigez les entrées utilisateur en termes de grammaire, d'orthographe et de ponctuation.
• Libellés : libellez chaque correction par type d'erreur.
• Explication : définissez l'erreur ou expliquez pourquoi la correction était nécessaire en langage simple.

Cas d'utilisation

Vous pouvez utiliser l'API Proofreader pour de nombreuses raisons. Par exemple :

• Suggérez des corrections aux messages de forum, aux commentaires sur les articles et aux e-mails avant leur envoi.
• Fournissez des corrections pendant la prise de notes active.

Votre cas d'utilisation n'est pas mentionné ? Rejoignez le programme Preview pour nous faire part de vos commentaires.

Premiers pas

Participez à l'essai Origin Trial de l'API Proofreader, qui se déroule dans Chrome 141 à 145.

Ajouter la prise en charge de localhost

Toutes les API d'IA intégrées sont disponibles sur localhost dans Chrome. Définissez les indicateurs suivants sur Activé :

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

Cliquez ensuite sur Relancer ou redémarrez Chrome. Si vous rencontrez des erreurs, résolvez les problèmes liés à localhost.

S'inscrire à la phase d'évaluation

Pour commencer à utiliser l'API Proofreader, procédez comme suit :

1. Acceptez le Règlement sur les utilisations interdites de l'IA générative de Google.
2. Accédez à l'essai Origin Trial de l'API Proofreader.
3. Cliquez sur S'inscrire et remplissez le formulaire. Dans le champ "Origine Web", indiquez votre origine ou l'ID de votre extension, chrome-extension://YOUR_EXTENSION_ID.
4. Pour envoyer le formulaire, cliquez sur S'inscrire.
5. Copiez le jeton fourni et ajoutez-le à chaque page Web participante de votre origine ou incluez-le dans le fichier manifeste de votre extension.
   • Si vous créez une extension, suivez les instructions de l'essai Origin Trial pour les extensions.
6. Commencez à utiliser l'API Proofreader.

Découvrez comment commencer à utiliser les phases d'évaluation.

Utiliser l'API Proofreader

Pour déterminer si le modèle est prêt à être utilisé, appelez Proofreader.availability(). Si la réponse à availability() est "downloadable", écoutez la progression du téléchargement et informez l'utilisateur, car le téléchargement peut prendre du temps.

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

Pour déclencher le téléchargement et instancier le correcteur orthographique, vérifiez l'activation de l'utilisateur. Appelez ensuite la fonction asynchrone Proofreader.create().

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

Créer un objet Proofreader

Pour créer un correcteur orthographique, utilisez la fonction Proofreader.create().

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

La méthode create() inclut les options suivantes :

• expectedInputLanguages : un tableau de langues d'entrée attendues.

Les options includeCorrectionTypes et includeCorrectionExplanation du présentateur ne sont pas prises en charge.

Commencer à relire le texte de l'utilisateur

Appelez proofread() pour obtenir des corrections pour un texte d'entrée :

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

Les corrections sont un type de ProofreadResult. Recherchez l'entrée entièrement corrigée dans l'attribut correctedInput et la liste des corrections dans le tableau 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);
}

Règles d'autorisation, iframes et Web Workers

Par défaut, l'API Proofreader n'est disponible que pour les fenêtres de premier niveau et leurs iframes de même origine. L'accès à l'API peut être délégué à des iframes d'origine croisée à l'aide de l'attribut allow="" de la règle d'autorisation :

<!--
  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 n'est pas disponible dans les Web Workers. Cela est dû à la complexité de l'établissement d'un document responsable pour chaque worker, afin de vérifier l'état de conformité avec les règles de la règle d'autorisation.

Démo

Essayez le bac à sable de l'API Proofreader et consultez le code source.

Participer et envoyer des commentaires

L'API Proofreader fait l'objet de discussions actives et est susceptible d'être modifiée à l'avenir. Si vous essayez cette API et que vous avez des commentaires, n'hésitez pas à nous en faire part.

• Lisez l'explication, posez des questions et participez à la discussion.
• Consultez l'implémentation pour Chrome sur l'état de Chrome.
• Consultez la position des normes Mozilla et la position des normes WebKit.
• Rejoignez le programme Preview pour découvrir les nouvelles API et accéder à notre liste de diffusion.
• Si vous avez des commentaires sur l'implémentation de Chrome, signalez un bug dans Chromium.

Découvrez toutes les API d'IA intégrées qui utilisent des modèles, y compris des grands modèles de langage, dans le navigateur.