Kurulum ve Yapılandırma
Başlamak için, diliniz için resmi OpenAI SDK'sının yüklü olduğundan emin olun. API, standart bir başlık tabanlı kimlik doğrulama şeması kullanır. Authorization başlığını Bearer your-api-key olarak ayarlamanız ve temel URL'yi https://api.glmapi.cc/v1 olarak yapılandırmanız gerekir. Bu URL, OpenAI Chat Completions formatını destekleyen herhangi bir istemci ile çalışır.
Standart yapılandırmaya ek olarak özel bir istemci başlatma işlemi gerekmez. Hizmet, mevcut OpenAI entegrasyonlarınız için doğrudan değiştirilebilir bir alternatif olarak çalışır. Kurulumunuzu doğrulamak için mevcut modeller uç noktasını kontrol edebilirsiniz.
İlk İstek
Bağlantıyı test etmek için basit bir metin tamamlama isteği gönderin. Birincil büyük dil modeli için uncensored model tanımlayıcısını kullanın. API, max_tokens ve temperature gibi standart parametreleri kabul eder.
Bu istek doğrudan bir metin yanıtı döndürür. 401 hatası alırsanız API anahtarınızı doğrulayın. 402 hatası, yetersiz ön ödemeli kredi olduğunu gösterir.
curl https://api.glmapi.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK Entegrasyonu
API ile etkileşim kurmak için resmi Python kütüphanesini kullanın. İstemcinizi temel URL ve API anahtarınızla başlatın. Sözdizimi, standart OpenAI istemci yapısıyla benzerlik gösterir.
Bu yaklaşım, iş mantığını yeniden yazmadan sağlayıcıları değiştirmenize olanak tanır. Model standart istem formatlarına yanıt verir. Çıktı uzunluğunu ve rastgeleliği standart parametreler aracılığıyla kontrol edebilirsiniz.
from openai import OpenAI
client = OpenAI(base_url="https://api.glmapi.cc/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node SDK Entegrasyonu
JavaScript ortamları için Node SDK'sını kullanın. baseUrl değerini API uç noktamıza işaret edecek şekilde yapılandırın. Bu, tüm isteklerin sunucularımıza doğru şekilde yönlendirilmesini sağlar.
SDK, yeniden denemeleri ve yanıt ayrıştırmayı otomatik olarak yönetir. Standart tamamlama parametrelerini iletebilirsiniz. Yanıt nesnesi, oluşturulan metini beklenen konumda içerir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.glmapi.cc/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Akışlı Yanıtlar
stream parametresini true olarak ayarlayarak akışı etkinleştirin. API, verileri Sunucu Tarafı Olayları (SSE) aracılığıyla parça parça gönderir. Her parça kısmi metin ve kullanım istatistikleri içerir.
Bu yöntem, uzun yanıtlar için algılanan gecikmeyi azaltır. Token'ları geldikçe işleyebilirsiniz. Son parça, faturalandırma için toplam token sayısını içerir.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limitler, Hatalar ve Bağlam
Bağlam penceresi toplamda 100.000 token destekler ve maksimum çıktı 32.000 token ile sınırlıdır. 8 MB gövde sınırını aşan istekler başarısız olur. Dakikada 300 istek ve anahtar başına 8 eşzamanlı istek ile sınırlısınız.
401 hatası geçersiz bir anahtarı gösterir. 402 hatası kalan ön ödemeli kredi olmadığını belirtir. 429 hatası hız limitini işaret eder. Kredi süresi dolmaz ve hatalar token tüketmez. Gizlilik korunur; istemler eğitim için kullanılmaz.
Teknik özellikler
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Model kimliği | uncensored |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.glmapi.cc/v1 |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| JSON modu | response_format: {"type": "json_object"} |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| İstek boyutu | en fazla 8 MB |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yükleme | USDT (TRC20) veya USDC (Base), $20–$500 arası herhangi bir tam tutar |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Fiyat | 1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50 |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Giriş | Google veya e-posta ve şifre |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bu resmi GLM API'si mi?
Hayır, bu bağımsız bir hizmettir. Kendi sansürsüz modelimizi çalıştırırız ve OpenAI uyumlu bir arayüz sağlarız. Orijinal GLM geliştiricileri ile bir bağlantımız yoktur.
API için nasıl ödeme yaparım?
Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile bakiye yüklemeleri kabul ediyoruz. Minimum bakiye yükleme miktarı $20'dur. Ön ödemeli kredi, token kullanımına göre yüklendiği kadar ödenir ve süresi asla dolmaz.
Bağlam penceresi boyutu nedir?
Model 100.000 token'lık bir bağlam penceresini destekler. Her istek için maksimum çıktı 32.000 token'dır, aksi belirtilmedikçe.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı budur.