Documentation

Tout ce qu'il faut savoir pour installer, configurer et utiliser Alt Text IA — du premier réglage à la génération en masse.

1. Installation

  1. Depuis votre tableau de bord WordPress, allez dans Extensions > Ajouter une extension.
  2. Recherchez « Alt Text IA ».
  3. Cliquez sur Installer, puis Activer.

Un nouveau menu Réglages > Alt Text IA apparaît dans votre tableau de bord.

2. Obtenir une clé API (mode gratuit)

En mode gratuit, vous utilisez votre propre clé API auprès du fournisseur IA de votre choix. C'est gratuit à obtenir, et la plupart proposent un quota d'usage gratuit suffisant pour tester.

Option recommandée : Google Gemini (gratuit, sans carte bancaire)

  1. Rendez-vous sur aistudio.google.com/apikey
  2. Connectez-vous avec un compte Google
  3. Cliquez sur « Create API key »
  4. Copiez la clé générée

Alternative : OpenAI

  1. Créez un compte sur platform.openai.com
  2. Allez dans API Keys, cliquez sur « Create new secret key »
  3. Une carte bancaire peut être demandée selon votre compte (facturation à l'usage, quelques centimes par génération)

Alternative : Anthropic Claude

  1. Créez un compte sur console.anthropic.com
  2. Allez dans API Keys, créez une nouvelle clé

3. Configuration du plugin

  1. Allez dans Réglages > Alt Text IA
  2. Choisissez votre Fournisseur IA dans la liste déroulante
  3. Collez votre Clé API dans le champ correspondant
  4. Indiquez la Langue de génération souhaitée (ex : fr_FR pour du français)
  5. Vérifiez que « Générer automatiquement... » est coché
  6. Cliquez sur Enregistrer
La langue de génération n'est pas détectée automatiquement à partir de votre contenu : c'est vous qui la définissez. Si vos textes reviennent en anglais alors que vous attendiez du français, vérifiez ce champ en premier.

4. Comment ça fonctionne

Génération automatique : à chaque nouvelle image envoyée dans votre médiathèque, Alt Text IA génère un texte alternatif si l'image n'en a pas déjà un. Une image qui a déjà un texte alternatif n'est jamais modifiée.

Analyse de la médiathèque : le bouton « Analyser ma médiathèque » (dans les réglages) scanne toutes vos images existantes et affiche combien n'ont pas de texte alternatif — disponible en gratuit comme en Pro.

Génération en masse (fonctionnalité Pro) : traite automatiquement toutes les images détectées par l'analyse, sans avoir à les modifier une par une.

5. Limites du mode gratuit

FonctionnalitéGratuitPro
Génération automatique à l'upload10 / moisIllimité
Clé APILa vôtreIncluse
Génération en masse (existant)—✓

Le quota gratuit se réinitialise automatiquement au 1er de chaque mois.

6. Dépannage

SymptômeCause probable
Le texte alternatif reste vide après uploadClé API manquante ou invalide, quota mensuel atteint, ou case « Génération automatique » décochée
Le texte est dans la mauvaise langueChamp « Langue de génération » à corriger dans les réglages
Rien ne se passe sur une image déjà existanteNormal : la génération automatique ne s'applique qu'aux nouveaux envois. Utilisez « Analyser ma médiathèque », puis passez en Pro pour traiter l'existant en masse
Erreur affichée mentionnant un « modèle » IALe fournisseur choisi a changé la disponibilité d'un modèle ; le plugin réessaie automatiquement avec un autre modèle disponible à la prochaine tentative
Si un problème persiste après avoir vérifié ces points, vérifiez le quota et la validité de votre clé directement sur le site du fournisseur (OpenAI, Google AI Studio ou Anthropic Console) — c'est la cause la plus fréquente.

7. Passer en Pro

Depuis Réglages > Alt Text IA, cliquez sur « Passer Pro pour débloquer la génération en masse ». Le paiement et la gestion de licence sont gérés de façon sécurisée par Freemius ; aucune clé API à configurer en mode Pro.