yanlış base_url kullanarak
Standart OpenAI base URL'si isteklerinizin başarısız olmasına veya tamamen farklı bir modele yönlendirilmesine neden olur. API'miz base URL'nin değiştirilmesini gerektirir base_url için https://api.whatisopenrouterai.com/v1. Yapılandırmadaki bu tek satır, SDK'nızın küresel OpenAI altyapısı yerine sunucularımıza bağlanmasını sağlar.
Birçok geliştirici, bu değişkeni güncellemeden mevcut kodlarını kopyalar-yapıştırır. Varsayılan URL'yi bırakırsanız, ya 404 hatası alırsınız ya da uncensored olmayan bir modele çarparsınız. Bağlantıyı kontrol ederek her zaman doğrulayın /v1/models endpoint. İlk tamamlama isteğinizi göndermeden önce yönlendirmenin doğru olduğunu doğrulamak için orada özel model kimliğinizin listelendiğini görmelisiniz.
model kimliğini ayarlamayı unutma
Doğru temel URL ile birlikte model kimliği eksik bırakılırsa varsayılan olarak genel veya eski bir modele geçilir. Modeli açıkça ayarlamanız gerekir, model parametresi "uncensored" her istekte. Yönlendirme katmanımıza, kısıtlamasız içerik için özelleştirilmiş belirli açık ağırlıklı modeli sunmasını söyler.
Bu açık talimat olmadan, farklı hizalama kurallarına sahip farklı bir model alabilirsiniz. Bazı modeller yasal yetişkin konularını varsayılan olarak reddeder. Zorlayarak uncensored ID, beklediğiniz davranımı garanti edersiniz. SDK varsayılanlarınızı geçersiz kılacak herhangi bir sabit kodlanmış model adı için kodunuzu kontrol edin.
token limitlerini ve hataları görmezden gelme
100,000 token'lık bağlam penceresini veya 16,000 token'lık çıktı limitini aşmak isteklerin hemen başarısız olmasına neden olur. API'miz istek başına maksimum 16,000 token çıktıyı zorunlu kılar. Ayarlamazsanız max_tokens, varsayılan değer yalnızca 2.048 token'dır. Bu, genellikle karmaşık akıl yürütme görevleri için çok kısadır.
Hatalar ve reddetmeler peşin kredinizi tüketmez. Ancak, hız sınırlarına takılan veya gövde boyutunu (8 MB) aşan hatalı istekler, kotalarınıza dahil edilir. Token kullanımını izlemek için yanıt başlıklarınızı izleyin. Bağlam penceresine sığacak şekilde prompt mühendisliğinizi ayarlayın. Bu, pahalı tekrar denemeleri önler ve veri akışının sorunsuz olmasını sağlar.
ön ödemeli faturalandırma yanlış anlaşılması
Hesabınızın bakiyesi aylık aboneliğe değil, ön ödemeli krediyi bağlar. Her 1M giriş token'ı için $0.15 ve her 1M çıktı token'ı için $0.50 ücretlendiriyoruz. Hatalar ücretsizdir, ancak başarılı tamamlamalar krediyi tüketir. Hizmet erişilebilirliğini sürdürmek için kripto aracılığıyla bakiye yüklemeniz gerekir.
Yüklemeler için USDT (TRC20) veya USDC (Base) kabul ediyoruz. Minimum yatırımlar $20'den başlar. Bonuslar daha yüksek seviyelerde geçerlidir: $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15. Kredi süresi dolmaz. Büyük toplu işler çalıştırmadan önce bakiyenizin pozitif olduğundan emin olun. Mevcut bakiyenizi ve son işlemlerinizi doğrulamak için panoyu kontrol edin.
standart yanıtlarla karıştırılan akış
SSE aracılığıyla akış, yanıt akışını nasıl ayrıştırdığınızı değiştirir. Standart yanıtlar tek bir JSON nesnesi döndürür. Akış, birden fazla parça döndürür. Hassas token kullanım istatistiklerini almak için son parçayı işlemelisiniz.
Akış (streaming) uygulamamız, son chunk'ta token kullanımını içerir. Akışı erken durdurursanız bu veriyi kaçırabilirsiniz. İstemci kitaplığınızın SSE'yi doğru şekilde desteklediğinden emin olun. Bu, tokenlar oluşturulurken görüntülendiği gerçek zamanlı uygulamalar için kritiktir. Yan yapılandırılmış akış, eksik metin veya bozuk UI durumlarına yol açabilir.
tool_choice yapılandırma hataları
Yanlış tool_choice ayarları, fonksiyon çağırmanın intendedi gibi çalışmasını engelleyebilir. Belirli bir aracı zorlayabilir veya modelin karar vermesine izin verebilirsiniz. Yan yapılandırma genellikle modelin mevcut işlevleri yok saymasına neden olur.
Kullan tool_choice modelin araçları otomatik olarak çağırıp çağırmayacağını kontrol etmek için. Değerini "auto" esneklik için veya kesin davranış için bir araç kimliği belirleyin. İşlev tanımlamalarınızın beklenen şemayla eşleştiğinden emin olun. Bu, model var olmayan bir işlevi çağırmaya çalıştığında çalışma zamanı hatalarını önler. Üretim ortamına geçmeden önce araç tanımlamalarınızı kapsamlı şekilde test edin.
eksik json_object modu
Without response_format: {"type": "json_object"}, model markdown veya düz metin çıktısı verebilir. Bu, sıkı JSON bekleyen parserları bozar. Tutarlı, ayrıştırılabilir bir çıktı için JSON modunu etkinleştirin.
Bu özellik, yapılandırılmış veri gerektiren aşağı akış sistemlerle entegrasyon için önemlidir. Son işleme yükünü önemli ölçüde azaltır. Müşteri kodunuzda her zaman çıktı şemasını doğrulayın. Bu, nadir model halüsinasyonlarına karşı sağlamlık sağlar. Varlık çıkarma veya yapılandırma dosyası oluşturma sırasında bu modu kullanın.
oran sınırları sürprizleri
API'miz, anahtar başına dakikada 300 isteğe olanak tanır. Bu limiti aşmak, 429 Too Many Errors yanıtına neden olur. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. Eşzamanlılık ayarlarınızı buna göre planlayın.
Birden fazla işlem çalıştırıyorsanız aynı anahtarı kullandıklarından veya ayrı anahtarlar oluşturduklarından emin olun. Her hesap yalnızca bir aktif anahtar destekler. Yeni anahtar eskisini değiştirir. Yanıtlardaki hız sınırı başlıklarını izleyin. Geri çekme mantığınızda üstel geri çekilme uygulayın. Bu, yüksek trafik dönemlerinde zincirleme hataları önler.
kripto yükleme gecikmeleri
Kripto işlemlerinin blok zincirinde onaylanması zaman alabilir. Fonları gönderdikten sonra krediniz anında görünmeyebilir. Doğru ağı kullanın: USDT için TRC20, USDC için Base. Yanlış ağa gönderim fon kaybına neden olur.
Yüklemeler $20 ile $500 arasındadır. Tam tutarı gönderdiğinizden emin olun veya ağ ücretlerini hesaba katın. İşlem hash'ini blokzinciri gezgininde kontrol edin. Kredi gecikirse, işlem ID'siyle destek ekibiyle iletişime geçin. Ödemenin hemen başarısız olduğunu varsaymayın. Ağ yoğunluğu sırasında sabırlı olmak, sorunsuz işlemler için önemlidir.
