API GLM 5.3 : raisonnement max, contexte 1M

zai/glm-5.3/chat

GLM 5.3 est le modèle de chat à long contexte pleine taille de Z.ai derrière un appel compatible OpenAI. Il lit jusqu’à 1 048 576 tokens, répond jusqu’à 131 072, avec effort de raisonnement jusqu’à max, 128 schémas d’outils par requête et sortie JSON.

Entrée $1.05Sortie $3.30par 1 million de tokensEntrée en cache $0.195Tarif officiel de Z.ai~~$1.40$4.40~~

Exécuter le modèle Voir l’API

Envoyer une requête

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations

POSThttps://api.spicyapi.ai/v1/chat/completions

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "zai/glm-5.3/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

256 tours ordonnés au maximum, contenu texte uniquement. Mettez la matière dans un message user, et la question plus le format de sortie dans le message system.

Valeur par défaut: Non définie
Contraintes: minItems:1
maxItems:256

messages[].rolestringObligatoire dans l’objet

Role of the message author.

Valeur par défaut: Non définie
Valeurs autorisées: "system""developer""user""assistant""tool"

messages[].namestringFacultatif

Optional name identifying the speaker within its role.

Valeur par défaut: Non définie

messages[].contentstring | array | nullFacultatif

Message content, either plain text or a list of content parts.

Valeur par défaut: Non définie

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Facultatif

Tool calls the assistant requested in this message.

Valeur par défaut: Non définie

messages[].tool_call_idstringFacultatif

Identifier of the tool call this message answers. Required on tool messages.

Valeur par défaut: Non définie

messages[].reasoning_contentstringFacultatif

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valeur par défaut: Non définie

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectFacultatif

Réclamez un objet JSON et nommez chaque clé dans le message system.

Valeur par défaut: Non définie

tool_choicestring | objectFacultatif

auto, none, required, ou un objet qui nomme une fonction.

Valeur par défaut: Non définie

parallel_tool_callsbooleanFacultatif

true ou false, true par défaut : le modèle peut demander plusieurs appels d’outils dans un même tour. Avec false, vous obtenez au plus un appel par tour, pour les boucles où chaque appel dépend du résultat précédent. Aucun effet sur le prix.

Valeur par défaut: true

toolsarray<object>Facultatif

Jusqu’à 128 définitions de fonctions par requête.

Valeur par défaut: Non définie
Contraintes: maxItems:128

top_pnumberFacultatif

0,01 à 1, 0,95 par défaut. Ajustez celui-ci ou temperature, jamais les deux dans la même comparaison.

Valeur par défaut: 0.95
Contraintes: minimum:0.01
maximum:1

temperaturenumberFacultatif

0 à 1, 1 par défaut. Gardez-le à 0 dès que la réponse est lue par du code.

Valeur par défaut: 1
Contraintes: minimum:0
maximum:1

seedintegerFacultatif

N’importe quel entier. Le même seed avec une requête par ailleurs identique rend les réponses très proches, ce qui permet de changer une seule chose à la fois et de comparer équitablement ; il ne garantit pas une sortie identique. Pas de valeur par défaut : chaque requête tire à nouveau. Aucun effet sur le prix.

Valeur par défaut: Non définie

max_tokensintegerFacultatif

Plafonne la réponse à 131 072. 32 768 par défaut ; relevez-le quand vous demandez le raisonnement et pas seulement le verdict.

Valeur par défaut: 32768
Contraintes: minimum:1
maximum:131072

stopstring | arrayFacultatif

Une seule séquence, sous forme de chaîne ou de tableau à un élément : Z.ai n’en lit qu’une. La réponse s’arrête dès que le modèle l’écrit, et le texte correspondant n’est pas renvoyé. Elle peut aussi se déclencher pendant le raisonnement et clore le tour avant toute réponse ; choisissez donc une chaîne que le raisonnement a peu de chances de contenir. Pas de valeur par défaut. Le tarif ne change pas : une réponse coupée plus tôt n’est facturée que pour les tokens produits.

Valeur par défaut: Non définie
Contraintes: minLength:1
minItems:1
maxItems:1

reasoning_effortstringFacultatif

low, high ou max. max est le défaut, comme sur l’API de Z.ai, et le cran des réponses qui doivent combiner correctement plusieurs faits à la fois ; descendez à low ou high pour les passes en volume.

Valeur par défaut: "max"
Valeurs autorisées: "low""high""max"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 1,
      "minItems": 1,
      "minLength": 1,
      "description": "A sequence that ends the reply as soon as the model writes it; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 0.95,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 32768,
      "maximum": 131072,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "high",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "max",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false
}

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "zai/glm-5.3/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Commandes de terminal et scripts d’automatisation.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instructions réutilisables pour votre assistant IA.

n8n

Nœuds communautaires pour n8n auto-hébergé et workflows HTTP Request à importer dans n8n Cloud.

ComfyUI

Workflows image, vidéo et audio sur un canevas de nœuds.

Autres intégrations

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Parcourir les workflows prêts à utiliser

C’est un modèle de conversation : il fonctionne partout où fonctionne l’API chat d’OpenAI. Gardez votre client, changez l’URL de base, désignez ce modèle par son identifiant.

Pointez ici n’importe quel client compatible OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/zai/glm-5.3/chat

Tout outil compatible avec l’API chat d’OpenAI s’utilise de la même façon — les SDK, le Vercel AI SDK, LangChain, aider, Cline. Le serveur MCP et la CLI spicyapi prennent en charge les tâches média asynchrones. Retrouvez la configuration de chaque outil dans l’espace développeurs.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez zai/glm-5.3/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

Base URL: https://api.spicyapi.ai/v1
Model: zai/glm-5.3/chat

Guide SillyTavern RisuAI, Agnai et d’autres Extension SillyTavern

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez zai/glm-5.3/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Exemples de workflows Guide d’installation Code source sur GitHub

Le panneau intégré lit le même schéma que cette page : il ne peut donc pas diverger de l’API. Si votre documentation a besoin d’un contenu indexable, récupérez plutôt le JSON sous /api/embed/models/ et affichez-le vous-même.

<iframe src="https://spicyapi.ai/embed/fr/models/glm-5-3/api?model=zai%2Fglm-5.3%2Fchat" width="100%" height="560" loading="lazy" title="Exemple de requête" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Ouvrir le panneau

Atelier

Envoyer une requête

Authentification API

Paramètres d’entrée

Lire le résultat

SDK et intégrations

L’utiliser dans SillyTavern et les applis de jeu de rôle

À utiliser dans ComfyUI