GLM api Anahtarı: Sorun Giderme Kılavuzu

Neden Anahtarınız 'Unauthorized' Döndürür

'Yetkisiz' hatası genellikle yapılandırılmış API anahtarınız ile base URL uç noktası arasındaki uyumsuzluktan kaynaklanır. Zed veya Trae gibi bir editöre yeni bir LLM entegre ederken, base URL'nin doğrudan sağlayıcının sohbet tamamlama uç noktasına işaret ettiğinden emin olmalısınız. OpenAI-uyumlu bir istemci kullanıyorsanız, hizmetimiz için base URL HTTPS://api.apiglm.com/v1 şeklindedir. Yanlış URL veya süresi dolmuş bir anahtar göndermek bu 401 yanıtını hemen tetikler.

Diğer bir yaygın neden, anahtarın yanlış başlık formatında gönderilmesidir. Bazı istemciler 'Authorization: Bearer ' beklerken, diğerleri giriş alanını yanlış yorumlayabilir. Anahtarın, Google veya e-posta ile giriş yaptıktan sonra panoda gösterildiği gibi tam olarak kopyalandığından emin olun. Telefon numarası doğrulama adımı yoktur, bu nedenle anahtar geçerliyse herhangi bir standart OpenAI SDK uygulamasında çalışmalıdır.

• Temel URL'nin (base URL) /v1 ile bittiğini kontrol edin.
• URL dizgisinde sondaki eğik çizgiler (trailing slashes) olmamalıdır.
• Anahtarın iptal edilmediğinden veya değiştirilmediğinden emin olun.

'Düşünme Bloğu' Sorununu İşleme

Mantık ağırlıklı modeller kullananlar sık sık, modelin bir etiket çıktıladığı ancak metin üretmediği boş 'düşünme' bloklarıyla karşılaşır. Bu her zaman kodunuzda bir hata değildir; altta yatan uncensored model mimarisinin bir davranışıdır. Model, boşluk veya null karakterler içeren bir mantık bloğu çıktılama kararı verebilir ve bu, ayrıştırıcınız tarafından boş yanıt olarak yorumlanabilir.

Bunu işlemek için istemcinizi boş düşünce etiketlerini yoksayacak veya işlemeden önce boşlukları silecek şekilde yapılandırın. Özel bir düşünce dönüştürücüsü kullanıyorsanız, bu uç durumları doğru şekilde işlediğinden emin olun. Model doğrudan yanıtlar için ayarlanmıştır, bu nedenle aşırı düşünce blokları bazen 'sıcaklık' veya 'top_p' parametrelerini daha doğrudan yanıtları teşvik edecek şekilde ayarlama ihtiyacını gösterebilir.

Bu, ham yanıt baytlarının günlüğe kaydedilmesini içerir. Düşünme bloğu mevcutsa ancak boşsa, onu atlamak ve gerçek içerik üretimine devam etmek güvenlidir. Bu, uygulamanızın mevcut olmayan metin için beklerken takılı kalmasını önler.

Editörlerde Temel URL'lerin Yapılandırılması

Zed veya Claude Code gibi yerel editörlere bir uncensored LLM entegre etmek varsayılan ortam değişkenlerinin geçersiz kılınmasını gerektirir. Çoğu editör varsayılan olarak OpenAI'nin base URL'ini kullanır. Yapılandırma dosyalarınızda base URL'i açıkça HTTPS://api.apiglm.com/v1 olarak ayarlamanız gerekir.

.env.development veya config.js dosyaları için API anahtar değişkeninin doğru şekilde eşitlendiğinden emin olun. Örneğin, base URL değişkenini uç noktamıza işaret edecek şekilde ayarlayın. Bu, işlev çağırma ve akış dahil tüm isteklerin altyapımız üzerinden yönlendirilmesini sağlar. Düzenleyici özel base URL'leri desteklemiyorsa, standart OpenAI protokolünü uç noktamıza çeviren bir proxy veya sarmalayıcı betik kullanmanız gerekebilir.

Basit bir 'ping' isteği göndererek entegrasyonu doğrulayın. Geçerli bir JSON yanıtı alırsanız, yapılandırmanız doğrudur. Bu adım, karmaşık çoklu konuşma denemelerinden önce kritiktir.

Saniye Başına İstek Limitleri ve Eşzamanlılık Hataları

Altyapımız, yüksek hacimli kullanımda kararlılığı sağlamak için sıkı hız sınırlamaları uygular. Her API anahtarı dakikada 300 isteğe limitlidir ve eşzamanlı olarak 8 isteği işleyebilir. Bu limitleri aşarsanız, 429 Too Many Requests hatı alırsınız.

Bu hatalardan kaçınmak için istemci kodunuzda üstel geri çekilme (exponential backoff) uygulayın. Mümkünse yanıtta 'Retry-After' başlığını izleyin. Ayrıca, uygulamanızın yoğun saatlerde trafik artışı yaşamadığından emin olun. Birden fazla örneğiniz varsa, yükü farklı anahtarlar arasında dağıtın veya eşzamanlılığı uygulama düzeyinde yönetin.

İstek gövdesi boyutu da 8 MB ile sınırlıdır. Büyük promptlar veya çok sayıda araç çağrısı bu sınırı aşabilir. Sınırlar içinde kalmak için girdinizi bölün veya eşzamanlı isteklerin sayısını azaltın. Bu sınırlar şeffaftır ve kaynak tükenmesini önlemek için tasarlanmıştır.

Token Sayma ve Bağlam Pencereleri

Token kullanımı, maliyet yönetimi açısından kritiktir. Modelimiz, hem promptu hem de tamamlamayı içeren 100,000 tokenlik bir bağlam penceresini destekler. İstek başına maksimum çıktı 16,000 token'dır; 'max_tokens' belirtilmezse bu değer 2,048 token olarak ayarlanır.

Fiyatlandırma, gerçek token kullanımına dayanır: milyon başına giriş token'ı için $0.15 ve milyon başına çıktı token'ı için $0.50. Hatalar ve reddetmeler ücretsizdir, bu nedenle yalnızca başarılı içerik üretimi için ödeme yaparsınız. Bu peşin ödeme modeli, bakiyenizin süresiz olarak geçerli olduğu ve istediğiniz zaman kripto para ile yükleme yapabileceğiniz anlamına gelir.

Yanıt meta verilerini ayrıştırarak token kullanımını uygulamanızda izleyin. Akış yanıtının son parçası toplam token sayısını içerir. Bu, maliyetleri gerçek zamanlı izlemenize ve bütçe içinde kalmak için istemlerinizi ayarlamanıza olanak tanır. Verimli token kullanımı, peşin kredinizin değerini maksimize etmek için anahtardır.

Akış Yanıtı Ayrıştırma

Akış yanıtları Sunucu Tarafı Olayları (SSE) aracılığıyla iletilir. Her parça yanıtın bir bölümünü içerir, ancak belirteç kullanım verileri yalnızca son parçada yer alır. Bu, akış tamamlanana kadar toplam belirteç kullanımını hesaplayamayacağınız anlamına gelir.

'data' olaylarını dinleyerek akışı ayrıştırın. Tam yanıtı oluşturmak için metin parçalarını birleştirin. Son parçayı aldığınızda, yerel token sayınızı güncellemek için 'usage' alanını ayıklayın. Bu yaklaşım, doğru faturalandırmayı sağlar ve kaynak tüketimini izlemenize yardımcı olur.

Ağ kesintilerini zarifçe yönetin. Akış kesilirse isteği yeniden denemeniz gerekebilir. İstemcinizin kısmi yanıtları işleyip doğru şekilde birleştirebildiğinden emin olun. Akış, gerçek zamanlı uygulamalar için idealdir ancak sağlam hata yönetimi gerektirir.

Fonksiyon Çağırma Parametre Hataları

Fonksiyon çağırma hassas parametre yapılandırması gerektirir. 'tools' dizinizin fonksiyon şemasını, parametreler ve açıklamalar dahil olmak üzere doğru şekilde tanımladığından emin olun. 'tool_choice' parametresi 'auto', 'required' veya belirli bir fonksiyon adı olarak ayarlanabilir.

Yaygın hatalar arasında araç şemasındaki gerekli alanların eksikliği veya yanlış veri türleri bulunur. Yapılandırılmış bir çıktı bekliyorsanız istemcinizin 'response_format' değerini 'json_object' olarak gönderdiğinden emin olun. Bu, modelin uygulamanızın ayrıştırabileceği geçerli JSON döndürmesini sağlar.

Önce basit araçlarla fonksiyon çağırma işlevini test edin. Karmaşıklığı kademeli olarak artırarak herhangi bir şema uyumsuzluğunu tespit edin. Model bir aracı çağıramazsa, yanıtın 'tool_calls' alanındaki hataları kontrol edin. Güvenilir fonksiyon çağırma için doğru yapılandırma esastır.

Kripto Yükleme Gecikmeleri Düzeltmeleri

Kredinizi bakiye yükleme kripto para ile yapılır; özellikle TRC20 üzerinde USDT veya Base üzerinde USDC. İşlemler blokzincir üzerinde onaylanırken birkaç dakika sürebilir. Krediniz hemen görünmezse, ağ onayını bekleyin.

Bonus krediler $50 veya üzeri yüklemeler için otomatik olarak uygulanır: $50 için +%5, $100 için +%10 ve $200 için +%15. Doğru bonusu almak için tam tutarı gönderdiğinizden emin olun. $20'nin altındaki veya $500'ün üzerindeki işlemler bonus alamayabilir veya reddedilebilir.

Çift ücretlendirme yaşarsanız Destek sayfası üzerinden destek ile iletişime geçin. Krediler iade edilmez ancak ayarlanabilir. Daha hızlı çözüm için işlem kimliğinizin kaydını tutun. Bu ön ödemeli model, süresi dolmadan kredi kaybetmeyeceğinizden emin olmanızı sağlar.

Model Kimliği Yan Yapılandırmaları

Yanlış model ID'si sıkça karşılaşılan bir hata kaynağıdır. Uncensored modelimiz için ID yalnızca 'uncensored'dur. 'gpt-4' veya 'claude-3' ile bir istek göndermek 'Model Bulunamadı' hatasına neden olur.

İstemciniz her istekte 'model' alanını 'uncensored' olarak açıkça ayarladığından emin olun. Bu, varsayılan olarak başka modellere geçebilecek OpenAI-uyumlu SDK'lar kullanırken kritiktir. Yapılandırma dosyalarınızda ve test isteklerinde model kimliğini doğrulayın.

Hizmetimiz model yönlendirmesi veya çoklu model seçenekleri sunmaz. Uncensored metin üretimi için adanmış tek bir model uç noktasıdır. Bu sadelik karmaşıklığı azaltır ve tutarlı performans sağlar. Üretim ortamına dağıtmadan önce model kimliğini her zaman iki kez kontrol edin.