Ce document décrit comment appeler le service d'inférence de modèle Z.AI sur Alibaba Cloud Model Studio.
Activation du service
- Accédez à la console Model Studio, recherchez ZHIPU/GLM, trouvez la carte du modèle de texte GLM-series Z.AI et cliquez sur Activer maintenant.
- Dans la boîte de dialogue, confirmez l'activation et l'autorisation.
Démarrage rapide
ZHIPU/GLM-5.3 est le modèle le plus récent de la série GLM et prend en charge un contexte de 1M. Exécutez le code suivant pour appeler rapidement le modèle ZHIPU/GLM-5.3 en mode réflexion.
Vous devez avoir obtenu une clé API et configuré la clé API comme variable d'environnement. Si vous appelez le modèle à l'aide d'un SDK, vous devez également installer le SDK.
- Compatibilité OpenAI
enable_thinking n'est pas un paramètre OpenAI standard. Dans le SDK Python OpenAI, vous le transmettez dans extra_body. Dans le SDK Node.js, vous le transmettez en tant que paramètre de niveau supérieur.- Python
- Node.js
- HTTP
Exemple de code
Réponse
Appel d'outil en streaming
Les modèles ZHIPU/GLM-5.3 et ZHIPU/GLM-5.2 prennent en charge le paramètre tool_stream. Ce paramètre est un booléen dont la valeur par défaut est false et qui fonctionne uniquement lorsque stream est true. Lorsqu'il est activé, les arguments du paramètre tool_call de Function calling sont retournés de manière incrémentielle sous forme de flux.
Les paramètres stream et tool_stream fonctionnent ensemble comme suit :
stream | tool_stream | Comment |
|---|---|---|
true | true |
|
true | false (par défaut) |
|
false | true/false |
|
- Compatible OpenAI
- Python
- Node.js
- curl
Exemple de code
Contrôle de la réflexion (thinking.type et reasoning_effort)
ZHIPU/GLM-5.3 s'exécute toujours en mode réflexion et ne prend pas en charge la désactivation de la réflexion. Maintenez thinking.type défini sur enabled (ou maintenez enable_thinking défini sur true), et utilisez reasoning_effort pour contrôler la profondeur de raisonnement.
Paramètre | Description | Valeurs prises en charge |
|---|---|---|
| Contrôle si la réflexion est activée. La valeur par défaut est |
|
| Contrôle la profondeur de raisonnement du modèle. Si ce paramètre n'est pas spécifié, la valeur par défaut est |
|
Effacer l'historique de raisonnement (clear_thinking)
Le paramètre clear_thinking contrôle si le reasoning_content (processus de raisonnement) des tours précédents est transmis au modèle comme contexte dans les conversations multi-tours. Seuls les modèles de la série GLM prennent en charge ce paramètre.
true: Ignore lereasoning_contentdes tours précédents et utilise uniquement le contenu non lié au raisonnement, tel que le texte visible, les appels d'outils et les résultats d'outils, comme contexte. Cela réduit la longueur du contexte et le coût.false(par défaut) : Conserve lereasoning_contentdes tours précédents et le fournit au modèle avec le contexte. Pour activer la préservation de la réflexion, vous devez transmettre intégralement lereasoning_contenthistorique dans les messages, sans modification et dans son ordre d'origine. L'omission, la troncature, la réécriture ou le réordonnancement dégrade l'effet ou empêche sa prise en compte.
assistant contiennent reasoning_content. Lorsque clear_thinking=true, le contenu de raisonnement historique n'est pas comptabilisé dans le contexte, donc prompt_tokens est inférieur à celui obtenu avec false (la valeur par défaut). La valeur réelle dépend de la longueur du reasoning_content historique.
- Compatible OpenAI
Autres fonctionnalités
| Modèle | Conversation multi-tours | Appel de fonction | Sortie structurée | Recherche Internet | Complétion de préfixe | Mise en cache du contexte | Contrôle de l'effort de raisonnement |
|---|---|---|---|---|---|---|---|
| ZHIPU/GLM-5.3 | Pris en charge | Pris en charge | Pris en charge | Non pris en charge | Pris en charge | Pris en charge | Pris en chargereasoning_effort |
| ZHIPU/GLM-5.2 | Pris en charge | Pris en charge | Pris en chargeMode sans réflexion uniquement | Non pris en charge | Pris en charge | Pris en charge | Pris en chargereasoning_effort |
- Le nombre minimum de jetons mis en cache est de 512, contre 1024 pour Model Studio.
Valeurs par défaut des paramètres
Modèle | enable_thinking | temperature | top_p | top_k | repetition_penalty |
|---|---|---|---|---|---|
ZHIPU/GLM-5.3 | true (ne peut pas être désactivé) | 1.0 | 0.95 | - | - |
ZHIPU/GLM-5.2 | true | 1.0 | 0.95 | - | - |
Liste des modèles et facturation
Les modèles de la série GLM sont des modèles de raisonnement hybrides de Z.AI. Ils sont conçus pour les agents intelligents et offrent deux modes : avec réflexion et sans réflexion. ZHIPU/GLM-5.3 prend en charge uniquement le mode avec réflexion.
Pour des informations sur la longueur du contexte du modèle et les tarifs, consultez la console Model Studioconsole Model Studio.
La facturation est basée sur les jetons d'entrée et de sortie du modèle.
En mode réflexion, la chaîne de pensée est facturée en fonction des jetons de sortie.
Codes d'erreur
Si une erreur se produit, voir Codes d'erreur pour résoudre le problème.
Voici les codes d'erreur de service spécifiques à Z.AI. Les codes d'erreur HTTP sont identiques aux codes d'erreur généraux de Model Studio. Voir le lien ci-dessus.
Catégorie d'erreur | Code d'erreur | Message d'erreur |
|---|---|---|
Erreur de base | 500 | Erreur interne |
Erreur d'authentification | 1000 | Échec de l'authentification |
1001 | Le paramètre d'authentification n'a pas été reçu dans l'en-tête. L'authentification ne peut pas être effectuée. | |
1002 | Le jeton d'authentification est invalide. Assurez-vous que le jeton d'authentification est transmis correctement. | |
1003 | Le jeton d'authentification a expiré. Régénérez-le ou obtenez-en un nouveau. | |
1004 | La vérification du jeton d'authentification a échoué. | |
1100 | Lecture/écriture de compte | |
Erreur de compte | 1110 | Votre compte est inactif. Vérifiez les informations de votre compte. |
1111 | Votre compte n'existe pas. | |
1112 | Votre compte est verrouillé. Contactez le service client pour le déverrouiller. | |
1113 | Votre compte présente un solde impayé. Rechargez votre compte et réessayez. | |
1120 | Impossible d'accéder à votre compte. Réessayez plus tard. | |
1121 | Compte verrouillé en raison d'une violation de politique. | |
Erreur d'appel d'API | 1200 | Erreur d'appel d'API |
1210 | Paramètres d'appel d'API invalides. Consultez la documentation. | |
1211 | Le modèle n'existe pas. Vérifiez le code du modèle. | |
1212 | Le modèle actuel ne prend pas en charge la méthode d'appel | |
1213 | Le paramètre | |
1214 | Le paramètre | |
1215 |
| |
1220 | Vous n'avez pas l'autorisation d'accéder à | |
1221 | L'API | |
1222 | L'API | |
1230 | Erreur de processus d'appel d'API. | |
1231 | Vous avez déjà une requête : | |
1234 | Erreur réseau. ID d'erreur : | |
1261 | Le prompt est trop long. | |
Erreur de blocage de politique d'API | 1300 | L'appel d'API a été bloqué par une politique. |
1301 | Le système a détecté du contenu potentiellement non sûr ou sensible dans l'entrée ou la sortie. Évitez d'utiliser des invites susceptibles de générer du contenu sensible. Merci de votre coopération. | |
1302 | La concurrence pour cette API est trop élevée. Réduisez la concurrence ou contactez le service client pour augmenter la limite. | |
1303 | Le taux de requêtes pour cette API est trop élevé. Réduisez le taux de requêtes ou contactez le service client pour augmenter la limite. | |
1304 | La limite d'appels quotidiens pour cette API a été atteinte. Pour augmenter la limite, contactez le service client. | |
1305 | La limite de trafic pour cette API a été atteinte. | |
1308 | La limite d'utilisation de | |
1309 | Votre plan Coding GLM a expiré et n'est pas disponible. Pour rétablir le service, renouvelez votre plan sur https://bigmodel.cn/claude-code. | |
1310 | La limite d'utilisation hebdomadaire/mensuelle a été atteinte. Votre limite sera réinitialisée à | |
1311 | Votre plan d'abonnement actuel n'inclut pas l'accès à | |
1312 | Ce modèle connaît un trafic élevé. Réessayez plus tard ou passez à un autre modèle tel que | |
1313 | L'utilisation de votre compte enfreint la politique d'utilisation équitable et votre taux de requêtes a été limité. Pour plus d'informations, consultez les « Conditions et accords - Accord d'abonnement et de renouvellement automatique ». Pour rétablir l'accès complet, allez dans Centre personnel > Aperçu du plan de programmation et demandez la levée de la restriction. |