Przewodnik dla deweloperów
GLM-5 API: od pierwszego zapytania po produkcję
§ 01Dwie ścieżki
Gdzie można wywołać GLM-5
Platforma Z.ai
Z.ai, twórca GLM, udostępnia własne API. Główny endpoint to https://api.z.ai/api/paas/v4/chat/completions i korzysta z protokołu OpenAI chat completions, dzięki czemu oficjalne SDK OpenAI działają po samej zmianie bazowego URL. Dokumentacja Z.ai wymienia również endpoint do kodowania (https://api.z.ai/api/coding/paas/v4), endpoint w stylu Responses (https://api.z.ai/api/v1) oraz endpoint kompatybilny z Anthropic (https://api.z.ai/api/anthropic) dla narzędzi wymagających tych formatów.
W Z.ai identyfikatory modeli są krótkie: glm-5.3, glm-5.3-flash oraz glm-5.3-flashx. Tryb myślenia włącza się za pomocą "thinking": {"type": "enabled"}, a jego głębokość ustawia się parametrem reasoning_effort. Wymagane jest konto Z.ai i klucz API; aktualne stawki znajdziesz na oficjalnej stronie z cennikiem Z.ai.
OpenRouter
OpenRouter to agregator: jeden klucz i jeden endpoint (https://openrouter.ai/api/v1/chat/completions) zapewniają dostęp do każdego modelu GLM-5 obok modeli z innych laboratoriów. ID modeli zawierają prefiks dostawcy — z-ai/glm-5.3, z-ai/glm-5.3-flash itd. — a reasoning kontroluje się za pomocą pojedynczego obiektu reasoning, takiego jak {"effort": "low"}.
Ceny w poniższej tabeli pochodzą z platformy OpenRouter. To również przez OpenRouter działa darmowy czat na tej stronie, więc zachowanie widoczne w naszym czacie odpowiada temu, co uzyskasz z API.
- Wybierz Z.ai, jeśli zależy Ci na bezpośredniej platformie twórców, dedykowanym endpoincie do kodowania lub dostępie kompatybilnym z Anthropic.
- Wybierz OpenRouter, jeśli chcesz mieć jeden rachunek dla wielu rodzin modeli i wygodnie przełączać się między nimi.
- W obu przypadkach Twój kod to to samo żądanie w stylu OpenAI — ze zmienionym adresem bazowym URL i nazwą modelu.
§ 02Cennik
Ceny API GLM-5 na platformie OpenRouter
USD za 1 milion tokenów wraz z szacunkowym kosztem 1000 typowych tur czatu. Kliknij model, aby przejść do pełnego przewodnika.
| Model | ID modelu | Kontekst | Wejście / 1M | Wyjście / 1M | 1000 rozmów* |
|---|---|---|---|---|---|
| GLM-5 | z-ai/glm-5 | 205K | $1 | $3.20 | $3.74 |
| GLM-5-Turbo | z-ai/glm-5-turbo | 203K | $1.20 | $4 | $4.60 |
| GLM-5V-Turbo | z-ai/glm-5v-turbo | 203K | $1.20 | $4 | $4.60 |
| GLM-5.1 | z-ai/glm-5.1 | 205K | $1.40 | $4.40 | $5.18 |
| GLM-5.2 | z-ai/glm-5.2 | 1.05M | $0.0341 | $7 | $4.95 |
| GLM-5.3 | z-ai/glm-5.3 | 1.05M | $0.079 | $1.40 | $1.10 |
| GLM-5.3 Flash | z-ai/glm-5.3-flash | 1.05M | $0.0052 | $0.1985 | $0.15 |
| GLM-5.3 FlashX | z-ai/glm-5.3-flashx | 1.05M | $0.37 | $1.25 | $1.43 |
| GLM-5.3 Prime | z-ai/glm-5.3-prime | 1M | $2.80 | $8.80 | $10 |
*1000 tur czatu po 1500 tokenów wejściowych i 700 tokenów wyjściowych każda. Ceny na podstawie listy modeli OpenRouter w momencie publikacji; tokeny rozumowania (reasoning) są rozliczane jako tokeny wyjściowe.
§ 03Kod
Gotowe zapytania do skopiowania
Ustaw swój klucz w zmiennej środowiskowej — nigdy nie umieszczaj go w kodzie po stronie klienta ani w publicznym repozytorium.
OpenRouter
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-ai/glm-5.3",
"messages": [
{"role": "system", "content": "You are a concise senior engineer."},
{"role": "user", "content": "Explain idempotency keys in two paragraphs."}
],
"reasoning": {"effort": "low"},
"max_tokens": 1024,
"stream": false
}'Platforma Z.ai
curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ZAI_API_KEY" \
-d '{
"model": "glm-5.3",
"messages": [{"role": "user", "content": "Summarise the CAP theorem."}],
"thinking": {"type": "enabled"},
"reasoning_effort": "low"
}'Z.ai używa krótkich identyfikatorów modeli (glm-5.3, glm-5.3-flash) oraz osobnego przełącznika myślenia. Sprawdź dokumentację Z.ai, aby poznać najnowsze parametry i limity.
§ 04Szczegóły
Parametry, które mają znaczenie
Rozumowanie jest częścią odpowiedzi
GLM-5.3 zawsze przeprowadza rozumowanie przed udzieleniem odpowiedzi; Ty decydujesz, jak obszerne ma ono być. Karta modelu wymienia trzy poziomy reasoning_effort — low, high i max — oraz wskazuje, że wartością domyślną jest max, jeśli nic nie przekażesz. W przypadku czatu i prostych narzędzi ustaw jawnie niski poziom (low): odpowiedzi pojawią się szybciej i będą tańsze, ponieważ tokeny rozumowania są rozliczane jako dane wyjściowe.
Podczas streamingu przez OpenRouter proces rozumowania trafia do delta.reasoning, a ostateczny tekst do delta.content. Wyświetl to pierwsze jako zwijany panel „myślenia” lub ukryj, ale nie wklejaj go z powrotem do historii konwersacji.
Wysyłanie obrazów do GLM-5.3 Flash
GLM-5.3 Flash, GLM-5.3 FlashX i GLM-5V-Turbo obsługują obrazy. Wyślij wiadomość użytkownika jako tablicę części: część tekstową oraz część image_url, której parametr url jest publicznym adresem HTTPS lub adresem data URL w base64, takim jak data:image/jpeg;base64,…. Modele GLM-5.3 i GLM-5.3 Prime obsługują wyłącznie tekst, dlatego zapytania dotyczące obrazów kieruj do wersji Flash.
Zmień rozmiar dużych zdjęć przed ich wysłaniem. Dłuższy bok o długości około 1024 pikseli pozwala zachować niewielki rozmiar zapytania i jest w zupełności wystarczający do większości pytań o dokumenty, wykresy i zrzuty ekranu.
Limity kontekstu i wyjścia
GLM-5.2, GLM-5.3 i GLM-5.3 Flash oferują na OpenRouter kontekst rzędu 1 048 576 tokenów oraz do 943,718 tokenów wyjściowych. Nie oznacza to jednak, że należy wykorzystywać cały limit przy każdym wywołaniu: tokeny wejściowe w tych modelach są tanie, ale długie odpowiedzi już nie, dlatego ograniczaj max_tokens do wartości, którą Twój interfejs może faktycznie wyświetlić.
W przypadku agentów dbaj o niezmienność promptu systemowego i dopisuj nowe wiadomości na końcu konwersacji, zamiast przepisywać ją na nowo; dzięki temu dostawcy obsługujący buforowanie promptów mogą ponownie wykorzystać wcześniejszą pracę.
- Używaj stream: true w przypadku wszystkiego, na co bezpośrednio czeka użytkownik.
- Ponawiaj zapytania w przypadku kodów odpowiedzi 429, 502 i 503 z krótkim opóźnieniem (backoff).
- Rejestruj zużycie (usage) z ostatniego fragmentu odpowiedzi (chunku), aby na bieżąco monitorować wydatki.
§ 05FAQ
Pytania dotyczące GLM-5 API
Q01Czy GLM-5 API jest kompatybilne z OpenAI SDK?
Tak. Zarówno endpoint Z.ai, jak i OpenRouter akceptują żądania chat completions w formacie zgodnym z OpenAI. Wystarczy skierować bazowy adres URL w SDK na dostawcę i użyć nazwy modelu GLM.
Q02Który model GLM-5 jest najtańszy w wywołaniu?
GLM-5.3 Flash. Na platformie OpenRouter kosztuje $0.0052 za milion tokenów wejściowych i $0.1985 za milion tokenów wyjściowych, a do tego potrafi analizować obrazy i wideo.
Q03Jakie są identyfikatory modeli GLM-5.3?
Na OpenRouter: z-ai/glm-5.3, z-ai/glm-5.3-flash, z-ai/glm-5.3-flashx oraz z-ai/glm-5.3-prime. Na platformie Z.ai: glm-5.3, glm-5.3-flash i glm-5.3-flashx.
Q04Czy mogę wyłączyć rozumowanie (reasoning)?
GLM-5.3 na platformie Z.ai zawsze przeprowadza rozumowanie. Możesz je skrócić, ustawiając niski poziom wysiłku rozumowania (reasoning effort), co domyślnie robi nasz darmowy czat.
Q05Czy istnieje darmowe API dla GLM-5?
Ta strona nie oferuje publicznego API. Możesz przetestować GLM-5.3 i GLM-5.3 Flash za darmo na naszym czacie webowym, a następnie przejść do Z.ai lub OpenRouter w celu uzyskania dostępu programistycznego.
Wypróbuj teraz
Zadaj GLM-5.3 prawdziwe pytanie.
Bez konta, bez karty, bez instalacji. Wpisz pytanie i zobacz, jak GLM-5.3 Flash odpowiada w kilka sekund — przełącz się na GLM-5.3 przy najtrudniejszych problemach.