Guide de migration de l'API Pangram 3.0

L'API 3.0 de Pangram est désormais disponible ! Ce guide vous explique tout ce que vous devez savoir pour passer de nos points de terminaison v2 à 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 générés par l'IA. Les textes relevant de cette catégorie sont généralement rédigés à partir d'une contribution importante de l'IA et d'une intervention humaine, ce qui reflète la manière dont les gens utilisent réellement les outils d'IA aujourd'hui.

Principales modifications apportées au 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 considérée comme rédigée par un humain
• fraction_assistée_par_IA — partie classée comme assistée par l'IA
• fraction_ai — partie classée comme générée par l'IA

Ces trois domaines s'excluent mutuellement et couvrent l'ensemble des cas ; leur somme sera toujours égale à 1.

De plus, chaque document contient trois chaînes de prédiction correspondant à différents niveaux de détail :

• titre — par exemple, « Entièrement rédigé par un humain », « Avec l'aide de l'IA », « Détecté par l'IA »
• prévision — une explication détaillée de la classification. Par exemple : « Nous sommes convaincus que ce document a été entièrement généré par une IA » ou « Nous pensons que ce document a été rédigé avec l'aide d'une IA, mais qu'il n'a pas été entièrement généré par une 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 comporte les informations suivantes :

• étiquette — chaîne de classification (« Rédigé par un humain », « Rédigé avec une aide modérée de 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 — valeur scalaire comprise entre 0 et 1 indiquant le niveau d'assistance de 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 :

• Utilisation des résultats de Pangram dans un environnement de production
• Vous souhaitez améliorer la précision des résultats fournis par les derniers modèles d'IA ?
• Prévoyez de continuer à utiliser l'API Pangram après le 1er avril 2026

NON si :

• Vous êtes un chercheur et vous avez besoin d'une API statique pour garantir la reproductibilité

---

Chronologie

---

Terminaux 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
• dashboard-text.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évisions de Pangram, utilisez les champs de premier niveau :

Reproduction du comportement initial du point de terminaison : le point de terminaison initial n'utilisait que la première fenêtre du texte pour effectuer sa prédiction. Pour reproduire ce comportement :

Important : L'interprétation de score_d'assistance_IA diffère de probabilité. Ces champs ne présentent pas de correspondance biunivoque. Attendez-vous à davantage de prédictions dans la plage intermédiaire (0–1). Utilisez étiquette pour comprendre l'interprétation que nous proposons.

---

De text-batch.api.pangram.com

Il n'existe actuellement aucun point de terminaison de traitement par lots pour l'API v3. Utilisez une boucle pour traiter chaque élément individuellement, en suivant les 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

Modifications apportées à la fenêtre :

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

---

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 :

Champs modifiés :

---

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, n'hésitez pas à nous contacter à l'adresse support@pangram.com.