Temel URL'yi Anlama
Temel URL, istemcinizin istekleri nereye gönderdiğini tanımlar. Burada bir uyumsuzluk, hemen bağlantı hatalarına veya beklenmeyen model yanıtlarına neden olur. Birçok geliştirici standart OpenAI URL'nin evrensel olarak çalıştığını varsayar, ancak uncensored sağlayıcılar trafiği belirli model havuzlarına yönlendirmek için genellikle farklı uç noktalar kullanır.
Yapılandırmanızın https://api.openrouterabliteratedmodels.com/v1 hizmetimiz için. Üçüncü taraf bir toplayıcı kullanıyorsanız, temel URL'nin belgelerine tam olarak uyduğundan emin olun. Yanlış URL'ler genellikle 404 hatalarına veya amaçlanan sansürsüz varyant yerine varsayılan modellerden gelen yanıtlara neden olur.
- Ortam değişkenlerinizi
BASE_URLouAPI_HOST. - Yolun
/v1standart uyumluluk için. - Yoğun kullanım öncesi basit bir model listesi isteği ile bağlantıyı test edin.
Hız Sınırlarını İşleme
Rate limitler, belirli bir zaman dilimi içinde gönderebileceğiniz istek sayısını kısıtlar. API'miz, anahtar başına dakikada 300 istek sınırı uygular. Bu eşiği aşmak, pencere sıfırlanana kadar istekleri geçici olarak engelleyen HTTP 429 hatalarına neden olur.
Ayrıca, anahtar başına aynı anda 8 istek için eşzamanlılık sınırı vardır. Aynı anda 8'den fazla istek gönderirseniz, fazlalık istemci kitaplığınıza bağlı olarak kuyruğa alınır veya başarısız olur. Bu katı sınırlara takılmamak için uygulamanızın eşzamanlılığını izleyin. Sunucu üzerinde spam oluşturmadan 429 hatalarını zarifçe yönetmek için kodunuzda üstel geri çekilme (exponential backoff) stratejileri kullanın.
Her anahtarın hesabınıza özgü olduğunu unutmayın. Anahtarları birden fazla hizmette paylaşmak, bu sınırlara daha hızlı ulaşmanıza neden olabilir. Uygulamanızın farklı bölümleri için ayrı hız sınırları havuzları gerekiyorsa yeni bir anahtar oluşturun.
Akışlı ve Akışsız Yanıtlar
Akış, tokenlar oluşturulurken verileri artımlı olarak döndürürken, akış olmayan tam yanıtı bekler. Akış, gerçek zamanlı kullanıcı deneyimleri için esastır ancak Server-Sent Events (SSE)'nin dikkatli bir şekilde işlenmesini gerektirir.
Akış (streaming) sırasında, son parça token kullanım istatistiklerini içerir. İşlemeyi erken durdurursanız bu veriyi kaçırabilirsiniz. Girdi ve çıkış token sayılarını doğru bir şekilde almak için istemcinizin son SSE mesajını ayrıştırdığından emin olun. Akış olmayan yanıtlar daha basittir ancak uzun çıktılar için yüksek gecikmeye neden olabilir.
Kullanıcıların metni karakter karakter gördüğü sohbet arayüzleri için akış (streaming) modunu seçin. Toplu işleme veya tam yanıtı beklemeniz gereken durumlar için akış olmayan modu kullanın. API'miz her iki modu da stream parametresi istek gövdesinde.
JSON Modu Hataları
JSON modu, modelin programatik entegrasyon için kritik olan geçerli JSON çıkarmasını sağlar. Bu tür hatalar genellikle yanlış başlıklar veya şema eşleşmezliklerinden kaynaklanır. API response_format: {"type": "json_object"} katı JSON çıktısını zorlamak için.
Bozuk JSON alırsanız şema tanımınızı kontrol edin. Model, JSON yapısının dışında markdown kod blokları veya açıklayıcı metinler içerebilir. Markdown sınırlayıcılarını temizleyebilen veya çıktıyı beklenen şemanıza göre doğrulayabilen sağlam bir ayrıştırıcı kullanın. Modeli şaşırtacak aşırı karmaşık şemalardan kaçının.
Önce basit yapılarla başlayın. Modelin nerede zorlandığını belirlemek için karmaşılığı kademeli olarak artırın. Sıcaklığın uygun şekilde ayarlandığından emin edin, çünkü daha yüksek sıcaklıklar rastgeleliği artırabilir ve JSON geçerliliğini azaltabilir.
Token Sayısı Yanlış Hesaplamaları
Token sayıları faturalandırmanızı ve bağlam penceresi kullanımınızı belirler. Yan hesaplamalar beklenmedik ücretlere veya kesik yanıtlara yol açabilir. API'miz her 1M girdi tokenı için $0.15 ve her 1M çıktı tokenı için $0.50 ücretlendirir.
Modelin tokenizasyon şemasıyla eşleşen güvenilir bir tokenizasyon kütüphanesi kullanın. Farklı modeller boşlukları veya noktalama işaretlerini farklı şekilde tokenize edebilir, bu da yerel sayımınız ile API'nin sayımı arasında tutarsızlıklara yol açabilir. Doğru faturalandırma için her zaman yanıtta döndürülen token kullanımına güvenin.
Bağlam pencerenizin toplam 100.000 token olduğunu göz önünde bulundurun. Bu sınırı aşmak hatalara neden olur. Sınırlar içinde kalmak için eski mesajları veya özetleri kısaltın. Zaman içinde token kullanımınızı izleyerek prompt yapınızı optimize edin ve maliyetleri düşürün.
Kripto Ödeme Gecikmeleri
USDT (TRC20) veya USDC (Base) ile kripto yüklemeleri tarafımızda anında işlenir. Ancak ağ yoğunluğu bazen onaylarda hafif gecikmelere neden olabilir. Kayıp yaşamamak için doğru miktarı ve ağı gönderdiğinizden emin olun.
$20 ile $500 arasında tam miktarlarda yapılan yüklemeler. Bonus krediler otomatik olarak uygulanır: $50'den +%5, $100'den +%10 ve $200'den +%15. Ödemeyi onaylamak için işlem hash'ini doğrulayın. Krediler birkaç dakika içinde görünmezse, işlem durumunu kontrol etmek için blok zinciri gezginini kontrol edin.
Kredi süresi dolmaz, bu nedenle hemen kullanmak için acele etmenize gerek yoktur. Çift yansıtma gibi hatalar Destek sayfası üzerinden çözülür. Sorunlar ortaya çıkarsa kolay referans için işlem kayıtlarınızı saklayın.
Model Kimliği Yapılandırması
Model kimliği, kullandığınız uncensored modelin hangi sürümünü kullandığınızı tanımlar. Servisimiz için model kimliği uncensored. Yanlış bir kimlik kullanmak hatalara veya beklenmeyen davranışlara yol açabilir.
İsteklerinizin model: "uncensored" istem gövdesinde. Bu kimlik, kısıtlamasız yanıtlar için özelleştirilmiş spesifik açık ağırlıklı modelimize işaret eder. Genel bir tanımlayıcı değil, barındırılan örneğimize özgü bir göstergedir.
İstemci kütüphanenizin belgelerine model kimliğini nasıl ayarlayacağınız konusunda bakın. Bazı kütüphaneler bir model alanı, diğerleri farklı bir parametre kullanabilir. Uygulamanızda model kimliğinin tutarlı kullanımı karışıklığı önler ve her zaman hedeflenen uncensored modelini çağırdığınızdan emin olmanızı sağlar.
Bağlam Penceresi Aşmaları
Bağlam penceresi, tek bir istekte gönderebileceğiniz toplam token sayısını sınırlar. API'miz hem istem hem de tamamlama dahil olmak üzere 100,000 tokenlık bir pencere destekler. Bu limite aşmak bir hataya neden olur.
Bağlamı yönetmek için kayan pencere stratejisi uygulayın. Alan açmak için eski mesajları kaldırın veya özetleyin. Girdinizin token sayısını izleyerek 100,000 token sınırında kaldığından emin olun. Sınırı aşarsanız API isteği reddeder.
Şu max_tokens çıktı uzunluğunu kontrol eden parametre. İstek başına maksimum çıktı 16.000 tokendir. Bu parametreyi ayarlamak, aşırı token kullanımını önlemeye ve yanıtları uygulamanız için yönetilebilir sınırlar içinde tutmaya yardımcı olur.
Destek ve İade Politikası
Bakiye kullanıldıktan sonra iade edilmez ancak süresi dolmaz. Ödeme veya hizmetle ilgili sorunlarla karşılaşırsanız, belirtilen sayfa üzerinden Destek ile iletişime geçin. Çift ücret gibi hatalar Destek ekibi tarafından çözülür.
Teknik sorunlar için önce belgelere göz atın. API'miz basit olsa da, uç durumlar (edge cases) ortaya çıkabilir. Yardım isterken API anahtarınızı ve istek ayrıntılarınızı sağlayın. Yanıt süreleri değişkenlik gösterir ancak sorunları hızlı çözmeyi hedefliyoruz.
Bakiyenin ön ödemeli olduğunu unutmayın. Tüketilen kadar ödersiniz, hatalar ve reddetmeler ücretsizdir. Bu model faturalamada şeffaflık sağlar. Hesabınızla ilgili herhangi bir tutarsızlık veya soru için Destek sayfasını kullanın.
