API GLM 5.2: czat Z.ai, kontekst 1M, 131K

zai/glm-5.2/chat

GLM 5.2 to model czatu od Z.ai do długiego kontekstu, za wywołaniem zgodnym z OpenAI. Czyta do 1 048 576 tokenów, odpowiada do 131 072, ma dwa poziomy wysiłku rozumowania, 128 schematów narzędzi na żądanie i wyjście JSON.

Wejście $0.98Wyjście $3.08za 1 mln tokenówWejście z pamięci podręcznej $0.182Cena oficjalna Z.ai~~$1.40$4.40~~

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

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

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/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.2/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'

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Dla każdego logicznego żądania zachowaj jeden Idempotency-Key. Po przerwaniu połączenia nie wysyłaj automatycznie ponownie z nowym kluczem; zachowaj request_id, żeby sprawdzić przyjęte żądanie. Idempotentność nie odtwarza wcześniejszego strumienia czatu.

Parametry wejściowe

Parametry modelu umieść bezpośrednio w ciele żądania JSON, obok model. Ten endpoint nie używa opakowania input.

messagesarray<object>Wymagane

Najwyżej 256 uporządkowanych tur, treść wyłącznie tekstowa. Korpus umieść w jednej wiadomości użytkownika, a pytanie i format wyjścia w wiadomości systemowej.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:256

messages[].rolestringWymagane wewnątrz obiektu

Role of the message author.

Domyślnie: Nie określono
Dozwolone wartości: "system""developer""user""assistant""tool"

messages[].namestringOpcjonalne

Optional name identifying the speaker within its role.

Domyślnie: Nie określono

messages[].contentstring | array | nullOpcjonalne

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

Domyślnie: Nie określono

{
  "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>Opcjonalne

Tool calls the assistant requested in this message.

Domyślnie: Nie określono

messages[].tool_call_idstringOpcjonalne

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

Domyślnie: Nie określono

messages[].reasoning_contentstringOpcjonalne

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

Domyślnie: Nie określono

{
  "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_formatobjectOpcjonalne

Poproś o obiekt JSON i nazwij każdy klucz w wiadomości systemowej.

Domyślnie: Nie określono

tool_choicestring | objectOpcjonalne

auto, none, required albo obiekt wskazujący jedną funkcję.

Domyślnie: Nie określono

toolsarray<object>Opcjonalne

Do 128 definicji funkcji na żądanie.

Domyślnie: Nie określono
Ograniczenia: maxItems:128

top_pnumberOpcjonalne

Od 0,01 do 1, domyślnie 0,95. Reguluj to albo temperature, nigdy obu w tym samym porównaniu.

Domyślnie: 0.95
Ograniczenia: minimum:0.01
maximum:1

temperaturenumberOpcjonalne

Od 0 do 1, domyślnie 1. Trzymaj na 0 zawsze, gdy odpowiedź parsuje kod.

Domyślnie: 1
Ograniczenia: minimum:0
maximum:1

max_tokensintegerOpcjonalne

Ogranicza odpowiedź do 131 072, czyli jednej ósmej okna odczytu. Domyślnie 32 768. Tokeny rozumowania są rozliczane również jako wyjście, więc zostaw zapas powyżej oczekiwanej widocznej odpowiedzi.

Domyślnie: 32768
Ograniczenia: minimum:1
maximum:131072

stopstring | arrayOpcjonalne

Jedna sekwencja, jako string albo tablica z jednym elementem – Z.ai odczytuje tylko jedną. Odpowiedź kończy się, gdy tylko model ją zapisze, a dopasowany tekst nie jest zwracany. Może zadziałać już w trakcie rozumowania i zakończyć turę, zanim pojawi się odpowiedź, więc wybierz ciąg, który w rozumowaniu raczej się nie pojawi. Brak wartości domyślnej. Stawka się nie zmienia – odpowiedź ucięta wcześniej jest rozliczana tylko za wygenerowane tokeny.

Domyślnie: Nie określono
Ograniczenia: minLength:1
minItems:1
maxItems:1

reasoning_effortstringOpcjonalne

high albo max. Domyślny jest max, tak jak w API samego Z.ai, więc żądanie pomijające to pole dostaje od razu najstaranniejsze ustawienie; przy przebiegach masowych zejdź do high.

Domyślnie: "max"
Dozwolone wartości: "high""max"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "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": [
        "high",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "max",
      "description": "How much reasoning the model spends before answering."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false
}

Odczytaj wynik

Przy stream ustawionym na false żądanie zwraca gotową odpowiedź czatu od razu. Czytaj choices[].message; odpytywanie zadania nie jest potrzebne. Ustaw stream na true, jeśli twój klient obsługuje Server-Sent Events.

Przykład odpowiedzi po zakończeniu

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "zai/glm-5.2/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
  }
}

Przykładowa odpowiedź jest poglądowa. usage podaje liczbę tokenów; liczba tokenów i opłata zależą od twojego rzeczywistego żądania.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

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

Przeglądaj gotowe przepływy pracy

To model czatowy, więc działa wszędzie tam, gdzie działa czatowe API OpenAI: zostaw swojego klienta, zmień adres bazowy i wskaż ten model po jego identyfikatorze.

Podłącz dowolnego klienta zgodnego z OpenAI

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

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

Narzędzia obsługujące API czatu OpenAI działają w ten sam sposób: SDK, Vercel AI SDK, LangChain, aider i Cline. Serwer MCP i CLI spicyapi obsługują asynchroniczne zadania multimedialne. Konfiguracje poszczególnych narzędzi znajdziesz w centrum dla deweloperów.

Używaj w SillyTavern i aplikacjach do roleplayu

W SillyTavern, RisuAI, Agnai lub dowolnej aplikacji z ustawieniem zgodnym z OpenAI wklej poniższy bazowy URL i swój klucz API, a jako model wybierz zai/glm-5.2/chat. Wywołania prosto z przeglądarki są dozwolone, a suwaki, których ten model nie obsługuje, są pomijane zamiast odrzucane.

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

Przewodnik po SillyTavern RisuAI, Agnai i inne Rozszerzenie SillyTavern

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wybierz zai/glm-5.2/chat w węźle SpicyAPI Chat, aby używać tego modelu w schemacie ComfyUI.

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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/glm-5-2/api?model=zai%2Fglm-5.2%2Fchat" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Odczytaj wynik

SDK i integracje

Używaj w SillyTavern i aplikacjach do roleplayu

Użyj w ComfyUI