API Proofreader

Thomas Steiner

Alexandra Klepper

Publié le 4 septembre 2025

Explication	Web	Extensions	État de Chrome	Intention
GitHub	Origin Trial	Origin Trial	Afficher	Intent to Prototype

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 dans leurs outils de composition, comme dans Google Docs.

L'API Proofreader vous permet de proposer une relecture interactive à votre application ou extension Web, grâce à l'IA intégrée. Cette API propose les fonctions suivantes :

• Correction : corrige les fautes de grammaire, d'orthographe et de ponctuation dans les saisies des utilisateurs.
• Libellés : libellez chaque correction en fonction du type d'erreur.
• Explication : définition de l'erreur ou explication de la nécessité de la correction en langage simple.

Cas d'utilisation

Il existe de nombreuses raisons d'utiliser l'API Proofreader. Par exemple :

• suggérer des corrections pour les messages de forum, les commentaires sur les articles et les e-mails avant leur publication ;
• Fournir des corrections pendant la prise de notes active.

Votre cas d'utilisation est-il manquant ? Participez au programme Preview pour nous faire part de vos commentaires.

Commencer

Participez à la phase d'évaluation de l'API Proofreader, qui se déroule dans Chrome 141 à 145.

Ajouter la prise en charge de localhost

Pour accéder à l'API Proofreader sur localhost pendant l'Origin Trial, vous devez mettre à jour Chrome vers la dernière version. Ensuite, procédez comme suit :

1. Accédez à chrome://flags/#proofreader-api-for-gemini-nano.
2. Sélectionnez Activé.
3. Cliquez sur Relancer ou redémarrez Chrome.

S'inscrire à la phase d'évaluation de l'origine

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

1. Acceptez le Règlement de Google sur les utilisations interdites de l'IA générative.
2. Accédez à la phase d'évaluation de l'origine 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 valider, 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 la version d'essai des extensions.
6. Commencez à utiliser l'API Proofreader.

Découvrez comment faire vos premiers pas avec les versions d'essai des origines.

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, 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 : tableau des langues d'entrée attendues.

Les options includeCorrectionTypes et includeCorrectionExplanation de l'outil d'explication ne sont pas prises en charge.

Commencer à relire le texte de l'utilisateur

Appelez proofread() pour obtenir des corrections pour un texte saisi :

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 corrected 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 sur les autorisations, 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 employé, afin de vérifier l'état de la politique d'autorisation.

Démo

Testez l'atelier de l'API Proofreader.

Interagir et envoyer des commentaires

L'API Proofreader est en cours de discussion et peut être modifiée à l'avenir. Si vous essayez cette API et que vous avez des commentaires, n'hésitez pas à nous les faire parvenir.

• Lisez l'explication, posez des questions et participez à la discussion.
• Consultez l'implémentation pour Chrome sur Chrome Status.
• Consultez la position de Mozilla sur les normes et la position de WebKit sur les normes.
• Rejoignez le programme de preview anticipée pour découvrir en avant-première les nouvelles API et accéder à notre liste de diffusion.
• Si vous avez des commentaires sur l'implémentation de Chrome, signalez un bug 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.