Guide de migration vers Pangram 4

Guide de migration vers Pangram 4

Pangram 4 est désormais disponible dans notre API.

En raison de certaines mises à jour liées à la facturation, Pangram 3.3.2 reste la version par défaut et restera disponible jusqu'au 30 septembre 2026.

Ce guide présente tout ce que vous devez savoir sur la migration vers Pangram 4.

Quelles sont les nouveautés de Pangram 4 ?

Pangram 4 propose un modèle de détection plus précis, une détection des « humanizers » par segment et un ensemble simplifié d'étiquettes de classification. Consultez la fiche du modèle Pangram 4 pour plus d'informations !

La structure générale des réponses reste la même, de sorte que la plupart des intégrations ne devraient nécessiter que quelques modifications :

• Demandez explicitement le pangramme 4 à l'aide de modèle : « pangram-4 »
• Mise à jour vers la version 1.0.0 du SDK Python
• Prise en charge des nouvelles étiquettes de fenêtre Pangram 4
• Vous pouvez, si vous le souhaitez, utiliser les nouveaux champs d'humanisation
• Compte associé au compteur de facturation API mis à jour

Le Pangram 4 fait également son retour :

{
  "version": "4.0"
}

Dois-je migrer ?

OUI si :

• Vous souhaitez commencer à utiliser Pangram 4 avant qu'il ne devienne le navigateur par défaut ?
• Utilisez les étiquettes de fenêtre dans vos flux de travail d'application ou de production
• Vous souhaitez accéder aux nouveaux champs d'humanisation ?
• Vous avez besoin de temps pour tester votre intégration avant le 30 septembre ?
• Vous souhaitez évaluer le nouveau modèle de facturation en utilisant vos volumes de requêtes habituels ?

PAS ENCORE si :

• Il faut un peu plus de temps pour valider le Pangram 4 dans un environnement de test.
• Vous dépendez des chaînes de libellé exactes de Pangram 3.3.2 et n'avez pas mis à jour votre intégration
• Il convient d'examiner l'impact de la facturation au 100 mots sur votre utilisation

La version 3.3.2 de Pangram reste la version par défaut et restera disponible jusqu'au 30 septembre 2026.

Chronologie

Nous vous recommandons de tester Pangram 4 avant le 30 septembre, en particulier si votre intégration dépend de chaînes de caractères précises dans les libellés des fenêtres.

Migration de l'API REST

Pour ceux qui utilisent l'API REST, envoyez une requête PUBLICATION demande adressée à :

https://text.external-api.pangram.com/task

Le corps de la requête devrait désormais contenir :

{
  "text": "...",
  "model": "pangram-4"
}

Étant donné que Pangram 3.3.2 reste la version par défaut pendant la période de transition, vous devez demander explicitement Pangram 4.

Exemple de demande

curl --request POST \
  --url https://text.external-api.pangram.com/task \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data '{
    "text": "Your text goes here.",
    "model": "pangram-4"
  }'

Migration du SDK Python

Pour ceux qui utilisent le SDK Python, passez à la version 1.0 :

pip installer --upgrade pangram-sdk==1.0.0

Demandez ensuite explicitement Pangram 4 :

de pangramme import Pangram

client = Pangram()

résultat = client.prédiction(
    texte,
    modèle=« pangram-4 »,
)

Tout comme pour l'API REST, il est nécessaire de sélectionner explicitement Pangram 4 pendant la période de transition.

Modifications apportées au schéma de réponse

La structure générale des réponses reste la même, avec deux ajouts à chaque Pangram 4 windows[] élément :

Le Pangram 4 fait également son retour :

{
  "version": "4.0"
}

Migration des étiquettes de fenêtre

Le seul changement susceptible d'entraîner des incompatibilités est que les libellés des fenêtres de Pangram 4 sont désormais les suivants :

• Généré par l'IA
• Assisté par l'IA
• Rédigé par un humain

Assisté par l'IA remplace la version précédente Légèrement assisté par l'IA et Avec un recours modéré à l'IA étiquettes.

Si votre intégration utilise des chaînes de caractères précises pour les étiquettes, mettez-la à jour avant la migration.

Par exemple, un code qui traitait auparavant ces deux étiquettes générées par l'IA séparément :

if window["label"] in {
    "Lightly AI-Assisted",
    "Moderately AI-Assisted",
}:
    handle_ai_assisted(window)

Il faudrait le mettre à jour comme suit :

si fenêtre[« label »] == « Assisté par l'IA »:
    handle_ai_assisted(fenêtre)

Voici à quoi pourrait ressembler un gestionnaire d'étiquettes Pangram 4 complet :

étiquette = fenêtre[« label »]

si label == « Généré par l'IA »:
    handle_ai_generated(fenêtre)
elif label == « Assisté par l’IA »:
    handle_ai_assisted(fenêtre)
elif label == « Rédigé par un humain »:
    handle_human_written(fenêtre)
else:
    handle_unknown_label(fenêtre)

Nous vous recommandons de conserver une solution de secours pour les étiquettes inconnues plutôt que de partir du principe que l'API renverra toujours l'une des chaînes actuellement documentées.

Guide de migration sur le terrain

La plupart des champs de réponse de Pangram 3.3.2 ne nécessitent aucune modification lors du passage à Pangram 4.

Le principal problème de compatibilité est le suivant : windows[].label. Les deux catégories précédentes liées à l'IA ont été regroupées en une seule Assisté par l'IA étiquette.

Modifications apportées à la facturation

Une dernière remarque : nous modifions notre mode de facturation de l'API.

Nous améliorons la précision de notre compteur d'utilisation. Les demandes seront désormais facturées par tranche de 100 mots, et non plus par tranche de 1 000 mots. Cela sera avantageux pour bon nombre d'entre vous.

Mais attention : le Pangram 4 est un modèle plus grand et plus performant, ce qui nous a obligés à augmenter son prix.

Veuillez consulter la page « Tarifs » pour connaître les derniers prix !

Avant de transférer l'ensemble du trafic de production vers Pangram 4, vérifiez que le nouveau modèle de facturation correspond bien à la durée et au volume habituels des requêtes de votre application.

Processus de migration recommandé

1. Mettez à jour votre client

Les utilisateurs de l'API REST peuvent continuer à utiliser le point de terminaison de tâche existant.

Les utilisateurs du SDK Python doivent installer la version 1.0.0:

pip installer --upgrade pangram-sdk==1.0.0

2. Demander explicitement le pangramme n° 4

Ajoutez le paramètre « model » à chaque requête :

{
  "model": "pangram-4"
}

3. Mise à jour des comparaisons exactes d'étiquettes

Remplacer les vérifications concernant :

Légèrement assisté par l'IA
Modérément assisté par l'IA

Avec :

Assisté par l'IA

Vérifiez également que votre intégration prend en charge les quatre étiquettes exactes de Pangram :

Généré par l'IA
Avec l'aide de l'IA
Rédigé par un humain

4. Soutenir les nouveaux domaines

Mettre à jour les types de réponse, les schémas de validation, les modèles de base de données et les pipelines d'analyse afin de prendre en charge :

windows[].is_humanized
windows[].humanizer_score
version

Les nouveaux champs de la fenêtre peuvent être considérés comme facultatifs dans un premier temps si votre application n'utilise pas encore l'analyse d'humanisation.

5. Vérifier les hypothèses de facturation

Les demandes seront désormais facturées par tranche de 100 mots, et non plus par tranche de 1 000 mots.

Testez l'effet à l'aide d'un trafic de production représentatif.

Liste de contrôle pour la migration

• Mettre à jour le SDK Python vers pangram-sdk==1.0.0, le cas échéant
• Ajouter modèle : « pangram-4 » aux requêtes API
• Supprimer les dépendances vis-à-vis de Légèrement assisté par l'IA
• Supprimer les dépendances vis-à-vis de Avec un recours modéré à l'IA
• Assistance Assisté par l'IA
• Ajouter la prise en charge de windows[].is_humanized
• Ajouter la prise en charge de windows[].humanizer_score
• Vérifiez que la version de la réponse est "4.0"
• Consultez le nouveau système de facturation au 100 mots
• Testez la migration avant le 30 septembre 2026

Des questions ?

Nous avons hâte que vous puissiez tous utiliser Pangram 4. N'hésitez pas à nous contacter si vous rencontrez le moindre problème. Nous serons particulièrement réactifs dans les jours à venir !

Pour obtenir de l'aide concernant la migration, veuillez contacter support@pangram.com.