GLM API Rehberi: GLM-5.2, GLM-5.3 ve GLM-5.3-Flash

APIMaster ile Python veya curl kullanarak GLM-5.2, GLM-5.3 ve GLM-5.3-Flash çağırın. Chat, Responses, Messages, akış, JSON ve araç çağrıları test edildi.

glm-5.2, glm-5.3 veya glm-5.3-flash modellerini bir APIMaster API anahtarı ve https://apimaster.ai/v1 temel URL'siyle kullanın. OpenAI uyumlu uygulamalar için Chat Completions ile başlayın. Codex Responses kullanır; Claude Code Messages arayüzünü kullanır.

Bunlar APIMaster ağ geçidi entegrasyon sonuçlarıdır; her GLM üst akışının (upstream) her protokolü yerel olarak uyguladığı iddia edilmemektedir. GLM model ailesidir; OpenAI ve Anthropic SDK'ları istemci arayüzlerini sağlar.

Test edilen uyumluluk

Doğrulama 15 Eylül 2026 UTC tarihinde başlatıldı; herkese açık APIMaster uç noktası ve normal yönlendirme kullanıldı. Her model aşağıdaki kontrolleri tamamladı:

Kontrol	`glm-5.2`	`glm-5.3`	`glm-5.3-flash`
Chat Completions: normal ve akış	Başarılı	Başarılı	Başarılı
Responses: normal ve akış	Başarılı	Başarılı	Başarılı
Messages: normal ve akış	Başarılı	Başarılı	Başarılı
Fonksiyon/araç çağrısı ve araç sonucu gidiş-dönüşü, üç protokolde de	Başarılı	Başarılı	Başarılı
Chat JSON nesne çıktısı	Başarılı	Başarılı	Başarılı

Metin testleri yalnızca HTTP 200'ü değil, gerçek yanıtı ve akış sonlanma olayını kontrol etti. Araç testleri bir hava durumu fonksiyonu talep etti ve ardından yalnızca araç sonucunda sağlanan bir doğrulama kodu geri döndürdü. Bunlar işlevsel entegrasyon kontrolleridir; verim kıyaslamaları veya kullanılabilirlik SLA'sı değildir. Uzun oturumlar, maksimum bağlam, video ve tüm gelişmiş parametreler bu test matrisinin kapsamı dışındadır.

1. API anahtarı alın

Bir APIMaster API anahtarı oluşturun, istediğiniz modeli etkinleştirin ve hesabı finanse edin. Yukarıdaki tam model kimliklerini kullanın. BigModel, OpenAI veya Anthropic'ten alınan bir anahtar APIMaster'da kimlik doğrulaması yapamaz.

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

2. curl ile Chat Completions çağırın

curl --fail-with-body --max-time 120 'https://apimaster.ai/v1/chat/completions' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"glm-5.3-flash","messages":[{"role":"user","content":"Reply with exactly GLM_API_OK."}],"max_tokens":2048}'

choices[0].message.content değerini okuyun. Model değiştirmek için model alanını glm-5.2 veya glm-5.3 olarak değiştirin. Akıl yürütme (reasoning) modelleri, nihai yanıtı üretmeden önce çıktı bütçesinin bir kısmını tüketebilir.

3. Python OpenAI SDK'yı kullanın

python -m pip install -U openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIMASTER_API_KEY"],
    base_url="https://apimaster.ai/v1",
    timeout=120.0,
)

response = client.chat.completions.create(
    model="glm-5.3-flash",
    messages=[{"role": "user", "content": "Reply with exactly GLM_API_OK."}],
    max_tokens=2048,
)
print(response.choices[0].message.content)

Akış için stream=True ayarlayın. Boş choices durumunu kontrol edin: son usage parçası metin deltası olmadan yalnızca kullanım bilgisi içerebilir.

stream = client.chat.completions.create(
    model="glm-5.3-flash",
    messages=[{"role": "user", "content": "Explain binary search briefly."}],
    max_tokens=4096,
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices:
        text = chunk.choices[0].delta.content
        if text:
            print(text, end="", flush=True)
    if chunk.usage:
        print("\nUsage:", chunk.usage)

İlk olay görünür yanıt metni yerine akıl yürütme içerebilir. Bunu döndüren rotalarda asistan mesajlarını bir araç konuşmasına taşırken reasoning_content alanını koruyun; asistan mesajını yalnızca nihai metinden yeniden oluşturmayın.

4. Doğru uç noktayı seçin

Uygulama	Temel URL	İstek uç noktası
Python OpenAI SDK / Chat	`https://apimaster.ai/v1`	`/v1/chat/completions`
Responses API / Codex	`https://apimaster.ai/v1`	`/v1/responses`
Claude Code	`https://apimaster.ai`	`/v1/messages`

Minimal Responses isteği:

curl --fail-with-body --max-time 120 'https://apimaster.ai/v1/responses' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"glm-5.3","input":"Reply with exactly GLM_API_OK.","max_output_tokens":2048}'

Metni içerik türü output_text olan mesaj öğelerinden okuyun; akıl yürütme öğelerini ayrı tutun. Akış için stream: true kullanın ve response.completed ya da bir hata olayını kontrol edin.

Parametreler ve sorun giderme

Durum	Önerilen işlem
401	APIMaster anahtarını ve anahtarı veren hesabı kontrol edin.
404	İstemcinizin beklediği temel URL'yi kullanın; `/v1` yolunu çoğaltmayın.
Boş yanıt veya çıktı sınırı	Bitirme nedenini ve akıl yürütme kullanımını inceleyin; çıktı bütçesini artırın.
JSON çıktısı	Chat `response_format: {"type":"json_object"}` temel bir JSON testini geçti. Dönen JSON'u uygulamanızda doğrulayın.
`reasoning.summary` reddedildi	Destek seçilen üst akışa bağlıdır. Temel yapılandırma için bunu çıkarın. Başarılı bir ağ geçidi testi, yerel BigModel desteğini kanıtlamaz.
`thinking.type: disabled` reddedildi	Resmi GLM-5.3-Flash model kılavuzu yalnızca `enabled` değerine izin verir; akıl yürütmenin devre dışı bırakılmasını zorunlu kılmayın.
429 / 5xx / kesintiye uğrayan akış	İstek kimliğini, modeli, UTC saatini ve hatayı kaydedin. Güvenli olduğunda sınırlı yeniden denemeler kullanın; yürütülmüş araçları körlemesine tekrarlamayın.

Sıkça sorulan sorular

GLM-5.3-Flash APIMaster'da ücretsiz mi?

Flash kelimesi model adının bir parçasıdır; ücretsiz kullanım vaadi değildir. Güncel rota fiyatları için model marketplace sayfasına, gerçek ücretler için cüzdana bakın.

Yüksek önbellek isabet oranı her istek için geçerli mi?

Hayır. Önbellek yeniden kullanımı, eşleşen giriş öneklerine ve üst akışa bağlıdır. Dönen kullanım bilgilerini ve kullanım günlüklerinizi inceleyin. Önceki bir iş yükünün önbellek isabet oranı, yeni bir uygulama için garanti değildir.

Bu, tam OpenAI veya Anthropic uyumluluğunu kanıtlıyor mu?

Test edilen metin, akış, JSON ve araç iş akışlarını doğrular. Sağlayıcıya özgü alanlar, saklanan Responses durumu, yerleşik web araması ve multimedya ayrı doğrulama gerektirir.