Guide de migration vers l'API Pangram 3.0

L'API 3.0 de Pangram est disponible ! Ce guide couvre tout ce que vous devez savoir sur la migration de nos points de terminaison v2 vers la nouvelle API v3.

Quelles sont les nouveautés de la version 3 ?

Nous avons introduit une troisième catégorie de classification pour les textes assistés par l'IA. Les textes qui entrent dans cette catégorie sont généralement rédigés à partir d'une contribution importante de l'IA et de l'intervention humaine, reflétant ainsi la manière dont les gens utilisent réellement les outils d'IA aujourd'hui.

Modifications importantes du schéma

L'API v3 classe chaque document à l'aide de trois champs fractionnaires indiquant la proportion du document qui relève de chaque catégorie :

• fraction_humaine — partie classée comme écrite par un humain
• fraction_ai_assistée — partie classée comme assistée par IA
• fraction_ai — partie classée comme générée par IA

Ces trois champs s'excluent mutuellement et sont collectivement exhaustifs ; leur somme sera toujours égale à 1.

De plus, chaque document comprend trois chaînes de prédiction à différents niveaux de verbosité :

• titre — par exemple, « Entièrement rédigé par un humain », « Assisté par IA », « Détecté par IA »
• prédiction — explication détaillée de la classification. Par exemple, « Nous sommes convaincus que ce document a été entièrement généré par l'IA » ou « Nous pensons que ce document a été créé avec l'aide de l'IA, mais qu'il n'a pas été entièrement généré par l'IA ».
• prédiction_courte — par exemple, « Humain », « Mixte », « IA »

Analyse au niveau des fenêtres

Chaque document d'entrée est divisé en fenêtres. Chaque fenêtre est étiquetée avec :

• étiquette — chaîne de classification (« Humain », « Modérément assisté par l'IA », « Généré par l'IA », etc.)
• confiance — niveau de confiance généré par le modèle de détection de Pangram (« Élevé », « Moyen », « Faible »)
• score_d'assistance_IA — scalaire compris entre 0 et 1 indiquant l'ampleur de l'assistance fournie par l'IA

Remarque : d'autres mentions (« Légèrement assisté par l'IA », « Fortement assisté par l'IA ») devraient être introduites prochainement.

---

Dois-je migrer ?

OUI si vous :

• Utilisation des résultats Pangram dans un environnement de production
• Vous souhaitez améliorer la précision des résultats générés par les derniers modèles d'IA ?
• Prévoyez d'utiliser l'API Pangram au-delà du 1er avril 2026.

NON si vous :

• Vous êtes un chercheur qui a besoin d'une API statique pour la reproductibilité.

---

Chronologie

Date	Événement
11 décembre 2025	Pangram 3.0 publié via le tableau de bord
23 décembre 2025	Pangram 3.0 disponible via l'API
Fin janvier 2026	Pangram 3.1 est sorti (tableau de bord + API). Tous les utilisateurs de l'API 3.0 ont été automatiquement mis à niveau.
1er avril 2026	Fin de vie des API Pangram 2.0

---

Points de terminaison V2 (disponibles jusqu'au 1er avril 2026)

Les points de terminaison v2 suivants restent disponibles pendant la période de transition :

• text.api.pangram.com
• text-batch.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• tableau de bord-texte.api.pangram.com

---

Guide de migration sur le terrain

De text.api.pangram.com

Point final : https://text.api.pangram.com → https://text.api.pangram.com/v3

Pour une compréhension optimale des prédictions de Pangram, utilisez les champs de niveau supérieur :

Champ v2	Champ v3	Remarques
prédiction	titre	Valeurs telles que « Entièrement rédigé par un humain », « Assisté par IA », « Détecté par IA »
probabilité_ai	fraction_ai	Quantité de texte présumé généré par une IA
—	fraction_ai_assistée	Nouveau : quantité estimée comme étant assistée par l'IA
—	fraction_humaine	Quantité considérée comme écrite par l'homme

Correspondance avec le comportement initial du point final : le point final initial utilisait uniquement la première fenêtre du texte pour effectuer sa prédiction. Pour reproduire ce comportement :

Champ v2	Champ v3
prédiction	windows[0].label et windows[0].confiance
probabilité_ai	windows[0].ai_assistance_score

Important : L'interprétation de score_d'assistance_IA diffère de probabilité_aiCes champs ne sont pas biunivoques. Attendez-vous à davantage de prédictions dans la fourchette intermédiaire (0-1). Utilisez étiquette pour comprendre notre interprétation recommandée.

---

De text-batch.api.pangram.com

Il n'existe actuellement aucun point de terminaison par lots pour l'API v3. Utilisez une boucle pour traiter chaque élément individuellement, en suivant les instructions suivantes : text.api.pangram.com guide de migration ci-dessus.

---

De text-sliding.api.pangram.com

Point final : https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

Champ v2	Champ v3	Remarques
prédiction	titre ou prédiction	Différents niveaux de verbosité disponibles
prédiction_courte	prédiction_courte	Inchangé
probabilité_ai, probabilité moyenne de l'IA	fraction_ai, fraction_ai_assistée, fraction_humaine	Utilisez des champs de quantité plutôt que des scores de confiance agrégés.
max_ai_probabilité	fraction_ai (recommandé)	Champs de quantité préférés

Changements de fenêtre :

• Dans défilement du texte, les fenêtres sont chevauchement
• Dans la version 3, les fenêtres ne se chevauchent pas.

v2 Champ de fenêtre	Champ de fenêtre v3
windows[].prédiction	windows[].label + windows[].confiance
windows[].ai_probabilité	windows[].ai_assistance_score

---

De text-extended.api.pangram.com

Point final : https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

La plupart des champs restent inchangés :

Champ	Statut
titre	Inchangé
prédiction	Inchangé
prédiction_courte	Inchangé
fraction_humaine	Inchangé
fraction_ai	Inchangé
windows[].label	Inchangé
windows[].confiance	Inchangé
windows[].start_index	Inchangé
windows[].end_index	Inchangé

Champs modifiés :

Champ v2	Champ v3	Remarques
fraction_mixte	fraction_ai_assistée	Champ renommé pour plus de clarté
tableau de bord	lien_vers_le_tableau_de_bord_public	Champ renommé pour plus de clarté
probabilité moyenne de l'IA	fraction_ai, fraction_ai_assistée, fraction_humaine	Utilisez des champs de quantité plutôt que des scores de confiance agrégés.
max_ai_probabilité	fraction_ai, fraction_ai_assistée, fraction_humaine	Utilisez des champs de quantité plutôt que des scores de confiance agrégés.
windows[].ai_probabilité	windows[].ai_assistance_score	Les scores de probabilité et d'assistance de l'IA ne sont pas identiques. Utilisation étiquette pour obtenir des conseils.

---

Documentation

La documentation complète de l'API est disponible ici.

---

Des questions ?

Si vous avez des questions concernant la migration vers la version 3, veuillez nous contacter à l'adresse support@pangram.com.