Geliştirici kılavuzu
İlk istekten prodüksiyona GLM-5 API
§ 01İki yöntem
GLM-5'i nereden çağırabilirsiniz
Z.ai platformu
GLM'in geliştiricisi Z.ai, kendi API'sini sunmaktadır. Genel endpoint https://api.z.ai/api/paas/v4/chat/completions adresidir ve OpenAI chat completions protokolünü izler; bu sayede resmi OpenAI SDK'ları yalnızca base URL değiştirilerek çalışır. Z.ai dokümantasyonu ayrıca bu formatları bekleyen araçlar için bir kodlama endpoint'i (https://api.z.ai/api/coding/paas/v4), Responses tarzı bir endpoint (https://api.z.ai/api/v1) ve Anthropic uyumlu bir endpoint (https://api.z.ai/api/anthropic) listelemektedir.
Z.ai üzerinde model kodları kısadır: glm-5.3, glm-5.3-flash ve glm-5.3-flashx. Düşünme modu "thinking": {"type": "enabled"} ile açılır ve derinlik reasoning_effort ile ayarlanır. Bir Z.ai hesabı ve API anahtarına ihtiyacınız vardır; güncel tarifeler için Z.ai'nin kendi fiyatlandırma sayfasını kontrol edin.
OpenRouter
OpenRouter bir toplayıcıdır (aggregator): tek bir anahtar ve tek bir endpoint (https://openrouter.ai/api/v1/chat/completions) sayesinde diğer laboratuvarların modellerinin yanı sıra tüm GLM-5 modellerine erişebilirsiniz. Model ID'leri sağlayıcı öneki taşır — z-ai/glm-5.3, z-ai/glm-5.3-flash ve benzeri — ve reasoning, {"effort": "low"} gibi tek bir reasoning nesnesiyle kontrol edilir.
Aşağıdaki tablodaki fiyatlar OpenRouter'a aittir. Bu site de ücretsiz sohbetini OpenRouter üzerinden çalıştırmaktadır; dolayısıyla sohbetimizde gördüğünüz davranış, API'den alacağınız yanıtla birebir aynıdır.
- Geliştiricinin kendi platformunu, kodlama endpoint'ini veya Anthropic uyumlu erişimi istiyorsanız Z.ai'yi seçin.
- Birçok model ailesi için tek bir fatura ve modeller arasında kolay geçiş istiyorsanız OpenRouter'ı seçin.
- Her iki durumda da kodunuz, yalnızca farklı bir temel URL ve model adına sahip aynı OpenAI tarzı istektir.
§ 02Fiyatlar
OpenRouter üzerinde GLM-5 API fiyatları
1 milyon token başına USD ve 1.000 tipik sohbet turu için yaklaşık maliyet. Kapsamlı rehberi için bir modele tıklayın.
| Model | Model ID | Bağlam | Girdi / 1M | Çıktı / 1M | 1.000 sohbet* |
|---|---|---|---|---|---|
| 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 |
*Her biri 1.500 girdi ve 700 çıktı token'ından oluşan 1.000 sohbet turu. Fiyatlar yazım sırasındaki OpenRouter model listesinden alınmıştır; akıl yürütme token'ları çıktı olarak faturalandırılır.
§ 03Kod
Kopyalamaya hazır istekler
Anahtarınızı bir ortam değişkeninde tanımlayın — asla istemci tarafı koda veya herkese açık bir depoya eklemeyin.
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
}'Z.ai platformu
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 kısa model kodları (glm-5.3, glm-5.3-flash) ve ayrı bir düşünme anahtarı kullanır. Güncel parametreler ve sınırlar için Z.ai dokümantasyonuna göz atın.
§ 04Detaylar
Önem taşıyan parametreler
Akıl yürütme cevabın bir parçasıdır
GLM-5.3 cevap vermeden önce her zaman akıl yürütür; ne kadar yapacağını siz seçersiniz. Model kartında üç reasoning_effort seviyesi listelenir: low, high ve max. Hiçbir şey belirtmezseniz varsayılanın max olduğu ifade edilir. Sohbet ve basit araçlar için açıkça low seviyesini ayarlayın: cevaplar daha hızlı gelir ve daha az maliyetlidir, çünkü akıl yürütme token'ları çıktı olarak faturalandırılır.
OpenRouter üzerinden stream ederken, akıl yürütme delta.reasoning içinde ve nihai metin delta.content içinde gelir. İlkini daraltılabilir bir "düşünme" paneli olarak gösterin veya gizleyin, ancak bunu konuşma geçmişine tekrar yapıştırmayın.
GLM-5.3 Flash modeline görsel gönderme
GLM-5.3 Flash, GLM-5.3 FlashX ve GLM-5V-Turbo görselleri kabul eder. Kullanıcı mesajını parçalardan oluşan bir dizi olarak gönderin: bir metin parçası ve url değeri herkese açık bir HTTPS adresi ya da data:image/jpeg;base64,… gibi bir base64 veri URL'si olan bir image_url parçası. GLM-5.3 ve GLM-5.3 Prime yalnızca metin destekler, bu nedenle görsel isteklerini Flash modeline yönlendirin.
Büyük fotoğrafları göndermeden önce yeniden boyutlandırın. Uzun kenarın yaklaşık 1.024 piksel olması isteği küçük tutar ve belgeler, grafikler ile ekran görüntüleri hakkındaki çoğu soru için yeterlidir.
Bağlam ve çıktı sınırları
GLM-5.2, GLM-5.3 ve GLM-5.3 Flash, OpenRouter üzerinde 1.048.576 token'lık bir bağlam ve 943,718 adede kadar çıktı token'ı listeler. Bu, her çağrıda tamamını kullanmanız gerektiği anlamına gelmez: bu modellerde girdi token'ları ucuzdur, ancak uzun çıktılar değildir; bu nedenle max_tokens değerini arayüzünüzün gösterebileceği miktarla sınırlandırın.
Ajanlar (agents) için sistem istemini (system prompt) sabit tutun ve konuşmayı yeniden yazmak yerine sonuna ekleme yapın; istemleri önbelleğe alan sağlayıcılar böylece önceki çalışmaları yeniden kullanabilir.
- Bir kullanıcının beklediği her durum için stream: true kullanın.
- 429, 502 ve 503 yanıtlarını kısa bir bekleme süresiyle (backoff) yeniden deneyin.
- Harcamalarınızı takip etmek için son veri yığınından (chunk) kullanım bilgilerini günlüğe kaydedin (log).
§ 05SSS
GLM-5 API soruları
Q01GLM-5 API'si OpenAI SDK ile uyumlu mu?
Evet. Hem Z.ai uç noktası hem de OpenRouter, OpenAI tarzı chat completions isteklerini kabul eder. SDK'nın base URL değerini sağlayıcıya yönlendirin ve bir GLM model adı kullanın.
Q02Çağrılabilecek en ucuz GLM-5 modeli hangisidir?
GLM-5.3 Flash. OpenRouter üzerinde milyon girdi token'ı başına $0.0052 ve milyon çıktı token'ı başına $0.1985 maliyete sahiptir; ayrıca görsel ve videoları da okuyabilir.
Q03GLM-5.3 model ID'leri nelerdir?
OpenRouter üzerinde: z-ai/glm-5.3, z-ai/glm-5.3-flash, z-ai/glm-5.3-flashx ve z-ai/glm-5.3-prime. Z.ai platformunda: glm-5.3, glm-5.3-flash ve glm-5.3-flashx.
Q04Akıl yürütmeyi (reasoning) kapatabilir miyim?
GLM-5.3, Z.ai platformunda her zaman akıl yürütür. Ücretsiz sohbetimizin varsayılan olarak yaptığı gibi, düşük bir reasoning_effort talep ederek bunu kısa tutabilirsiniz.
Q05Ücretsiz bir GLM-5 API'si var mı?
Bu site herkese açık bir API sunmamaktadır. Web sohbetimizde GLM-5.3 ve GLM-5.3 Flash modellerini ücretsiz olarak test edebilir, ardından programatik erişim için Z.ai veya OpenRouter'a geçebilirsiniz.
Şimdi deneyin
GLM-5.3'e gerçek bir soru sorun.
Hesap yok, kart yok, kurulum yok. Bir soru yazın ve GLM-5.3 Flash'ın saniyeler içinde yanıtlamasını izleyin — en zorlu problemler için GLM-5.3'e geçin.