Migration API GLM : guide pratique pour mettre à jour vos appels
Récemment, de nombreux développeurs utilisant l'API de Zhipu AI (pour les modèles GLM) ont vu leurs applications s'arrêter brutalement, avec des erreurs HTTP 400. Si vous êtes dans ce cas, ne vous inquiétez pas. La cause est une migration de plateforme, et la solution est bien plus simple qu'il n'y paraît. En réalité, deux modifications suffisent à retrouver un état nominal.
La cause du problème : une migration de plateforme
Pour améliorer ses services, Zhipu AI a déplacé son infrastructure API vers une nouvelle adresse. L'ancien point d'accès, api.z.ai, n'est plus le bon. Toutes les requêtes envoyées vers cette ancienne URL sont désormais rejetées. C'est la raison principale pour laquelle vos appels ne fonctionnent plus. La nouvelle plateforme se trouve désormais sur le domaine open.bigmodel.cn.
La solution : mise à jour de l'URL et de la clé
Pour corriger l'erreur, il vous suffit de mettre à jour deux éléments dans votre configuration. Le reste de votre code, y compris la structure de votre requête (le payload), peut rester identique. Voici les deux étapes à suivre.
Étape 1 : Mettre à jour le point d'accès (URL)
Remplacez l'ancienne URL par la nouvelle dans votre code.
* Ancienne URL (obsolète) :https://api.z.ai/api/paas/v4/chat/completions
* Nouvelle URL (correcte) :https://open.bigmodel.cn/api/paas/v4/chat/completions
C'est ce changement qui indique à votre application où envoyer les requêtes.
Étape 2 : Générer une nouvelle clé API
Les anciennes clés API étaient liées à l'ancienne plateforme. Vous devez donc en générer une nouvelle.
1. Connectez-vous au nouveau portail développeur : https://open.bigmodel.cn/.
Petite attention cependant : le nouveau portail est encore en cours de traduction. Ne soyez pas surpris de voir de nombreux termes en chinois, notamment dans la documentation ou les messages du tableau de bord. L'essentiel pour générer votre clé reste cependant facile à identifier.
2. Allez dans la section "API Key" de votre tableau de bord.
3. Générez une nouvelle clé et copiez-la.
4. Remplacez votre ancienne clé dans l'en-tête Authorization de vos requêtes.
Et mon code de requête (le payload) ?
C'est le point le plus important de cette migration : vous n'avez pas besoin de modifier la structure de votre payload. Les paramètres que vous utilisiez avant, comme le modèle glm-4-flash ou même le paramètre thinking, sont toujours compris par la nouvelle API. Zhipu AI a mis en place une couche de compatibilité pour assurer une transition en douceur. Votre logique métier reste donc intacte.
La bonne nouvelle, c'est que les modèles que vous utilisiez sont toujours disponibles. Mieux, cette nouvelle plateforme ouvre la porte à de futurs modèles, potentiellement plus performants ou spécialisés, qui seront ajoutés au catalogue au fil du temps.
Exemple concret : avant et après
Voici comment votre configuration de base devrait être modifiée. Prenons l'exemple d'un tableau de configuration en PHP :
Avant (ne fonctionne plus) :json
{
"GLM": {
"header": [
'Content-Type: application/json',
'Authorization: Bearer VOTRE_ANCIENNE_CLE_API'
],
"url": "https://api.z.ai/api/paas/v4/chat/completions"
}
}
Après (fonctionne) :json
{
"GLM": {
"header": [
'Content-Type: application/json',
'Authorization: Bearer VOTRE_NOUVELLE_CLE_API'
],
"url": "https://open.bigmodel.cn/api/paas/v4/chat/completions"
}
}
Comme vous pouvez le voir, seules l'URL et la clé ont changé. Le reste est identique.
Un mot sur l'avenir et les tarifs
Si cette compatibilité est une excellente nouvelle aujourd'hui, gardez à l'esprit qu'elle pourrait être temporaire. À l'avenir, Zhipu AI pourrait décider de ne plus supporter les anciens paramètres. Il est donc sage de consulter régulièrement la documentation officielle pour vous tenir informé des évolutions.
Cette migration est aussi l'occasion pour Zhipu AI de repenser son modèle économique. Si l'offre gratuite actuelle est généreuse, il est possible que les tarifs évoluent. La fin de la "générosité" de certains modèles gratuits est une possibilité à surveiller. Nous vous conseillons de consulter la page de tarification officielle pour anticiper d'éventuels changements de coûts, surtout si votre application est destinée à un usage intensif.
Sources
- Nouveau portail développeur Zhipu AI : Pour créer votre compte et générer vos nouvelles clés API.
- Documentation de l'API GLM : Le point de référence pour les paramètres et les modèles supportés par la nouvelle plateforme.
- Page de tarification de Zhipu AI : Pour consulter les derniers coûts des modèles et anticiper les changements.
Pourquoi mes appels à l'API GLM ne fonctionnent-ils plus ?
Vos appels ne fonctionnent plus car Zhipu AI a migré son API vers une nouvelle plateforme (open.bigmodel.cn), rendant l'ancienne adresse (api.z.ai) et les anciennes clés API obsolètes.
Dois-je changer le corps de ma requête (le payload) ?
Non. C'est la bonne surprise de cette migration. La nouvelle plateforme est compatible avec l'ancien format des requêtes. Vous n'avez pas besoin de modifier votre payload pour l'instant.
Où puis-je trouver ma nouvelle clé API GLM ?
Vous devez vous connecter au nouveau portail de Zhipu AI à l'adresse open.bigmodel.cn, puis vous rendre dans la section "API Key" de votre tableau de bord pour en générer une nouvelle.
Les tarifs de l'API GLM vont-ils changer ?
C'est une possibilité. La migration de plateforme est souvent l'occasion pour les fournisseurs d'ajuster leur modèle économique. Il est prudent de surveiller la page de tarification officielle de Zhipu AI.
