uncensored.com LLM API'sinin Adım Adım Entegrasyonu
Uygulamanıza bir uncensored LLM entegre etmek base URL ve kimlik doğrulama başlıklarının hassas yapılandırılmasını gerektirir. Bu rehber, standart OpenAI-compatible SDK'lar kullanılarak metin oluşturma, akış ve araç kullanımı için uncensored.com API'sinin nasıl kurulacağını adım adım gösterir.
Son güncelleme
Özet
- API, tüm istekler için HTTPS://api.uncensoredaicom.com/v1 temel URL'sini ve "uncensored" model kimliğini kullanır.
- Kimlik doğrulama, Google veya e-posta ile kaydolduktan sonra elde edilen Authorization header'ında Bearer token aracılığıyla yapılır.
- Akış yanıtları, stream=true ayarlanarak etkinleştirilir ve belirteçler Sunucu Tarafı Olayları aracılığıyla iletilir.
- Fiyatlandırma, süresi dolmayan ön ödemeli kripto kredisi ile giriş tokenları başına milyon başına $0.15 ve çıktı tokenları başına milyon başına $0.50'dir.
Önkoşullar: SDK ve Ortam Kurulumu
Tercih ettiğiniz dilin SDK'sını yükleyin veya uç nokta ile iletişim kurmak için tercih ettiğiniz dilin istemcisini kullanın. Çoğu geliştirici Python, Node.js veya Go için resmi OpenAI SDK'sını kullanır. Bu, API'nin standart OpenAI sohbet tamamlama şemasını izlemesinden kaynaklanır.
Ortamınızın Python 3.8+ veya Node.js 18+ içerdiğinden emin olun. Paketi pip veya npm aracılığıyla yükleyin. Bir API anahtarına ihtiyacınız olacaktır. Kayıt için telefon numarası gerekmez.
- Python:
pip install openai - Node.js:
npm install openai
API anahtarınızı bir ortam değişkeninde saklayın. Bu, sürüm kontrolünde yanlışlıkla açığa çıkmasını önler. Anahtar, sansürsüz modele erişim sağlar.
Temel URL'yi Yapılandırma
SDK istemcinizi doğru temel URL'ye işaretleyin. Bu, başarılı entegrasyon için en kritik adımdır. Varsayılan OpenAI temel URL'si bu hizmet için çalışmaz.
Temel URL'yi HTTPS://api.uncensoredaicom.com/v1 olarak ayarlayın. Bu, istekleri filtrelenmemiş LLM altyapısına yönlendirir. Göndermeniz gereken model kimliği "uncensored"dir. Minimal reddetme için ayarlanmış açık ağırlıklı bir modeldir.
Bağlantıyı modeller uç noktasını çağırarak doğrulayın. Bu, kimlik bilgilerinizin ve temel URL'nizin doğru olduğunu onaylar. Başarılı bir yanıt model kimliğini ve nesne türünü döndürür.
Kimlik Doğrulama ve Header Kurulumu
API anahtarınızı Authorization başlığında iletin. Tüm istekler için Bearer şemasını kullanın. Bu başlık, ön ödemeli kredi hesabınızı doğrular.
Başlığı aşağıdaki gibi ayarlayın: Authorization: Bearer YOUR_API_KEY. SDK, bunu anahtarını istemci kurucusuna geçirdiğinizde otomatik olarak halleder. Fazladan boşluk karakteri olmadığından emin olun. Geçersiz anahtarlar 401 Unauthorized hatası döndürür.
Hesap başına bir aktif anahtarınız olur. Yeni bir anahtar oluşturmak önceki anahtarı geçersiz kılar. Bu, anahtar döndürme ve güvenlik yönetimini basitleştirir. Anahtarınızı dağıtım ortamınızda güvende tutun.
Standart Sohbet İsteği Gönderme
/v1/chat/completions adresine bir POST isteği gönderin. Mesajlarınızı role ve content nesnelerinden oluşan bir dizi olarak gönderin. Sistem user, assistant ve system rollerini destekler.
Örnek yapı: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API, bir metin tamamlama döndürür. Bağlam penceresi toplamda 100,000 token'dır. İstek başına maksimum çıktı 16,000 token'dır.
Hatalar ve reddetmeler kredi tüketmez. Bu, ön ödemeli bakiyenizi korur. Kontrol için sıcaklık ve top_p değerlerini ayarlayın. Varsayılan değerler çoğu kullanım durumu için çalışır.
Gerçek Zamanlı Çıktı İçin Akışın Etkinleştirilmesi
Ayarla stream: true istemci gövnenizde. Bu, Sunucu Tarafı Olayları (SSE)'yi etkinleştirir. Tokenlar, tam tamamlamayı beklemek yerine artımlı olarak gelir.
Metni gerçek zamanlı görüntülemek için SSE akışını ayrıştırın. Son parça token kullanım istatistiklerini içerir. Bu, doğru faturalandırma takibine olanak tanır. Akış, son kullanıcılar için algılanan gecikmeyi azaltır.
Ağ kesintilerini zarifçe yönetin. Akış kesilirse yeniden bağlanın. uncensored API kararlı akış desteği sağlar. Bağlantı durumunu izleyin. Bu, sohbet arayüzleri veya uzun formlu oluşturma için kullanın.
Araçlar ve Fonksiyon Çağırma Kullanımı
İstek gövbenize araçlar tanımlayın. Bir işlev şeması listesi iletin. Model, kullanıcı niyetine göre bu işlevleri çağırabilir. Bu, ajan benzeri davranışlar sağlar.
Belirt tool_choice işlev seçimini kontrol etmek için. Kullanın auto otomatik algılama için. API, standart araç tanımlarını destekler. Yanıttan fonksiyon çağırma argümanlarını ayrıştırın.
İşlev yürütmesini kodunuzda uygulayın. Sonucu bir mesaj olarak gönderin. Model konuşmaya devam eder. Bu karmaşık iş akışlarını mümkün kılar. Testler, doğru argüman ayrıştırmasını sağlar.
JSON Modu Yanıtlarını İşleme
Ayarla response_format: {"type": "json_object"}. Bu, modelin geçerli JSON çıktısı vermesini zorlar. Yapılandırılmış veri çıkarımı için kullanın. Bozuk yanıt hatalarının önlenmesine yardımcı olur.
Kodunuzdaki JSON dizisini ayrıştırın. Olası ayrıştırma hatalarını işleyin. JSON modu API entegrasyonları için güvenilirliği artırır. Veri işleme hatları için idealdir.
JSON modunu sistem prompt'ları ile birleştirin. Modeli belirli şemaları çıktıya yönlendirin. Bu, tutarlı biçimlendirmeyi sağlar. Kullanmadan önce çıktıyı doğrulayın. Bu, aşağı akış hatalarını azaltır.
Limitlerin ve Hataların İzlenmesi
Hız sınırlarına dikkat edin. Anahtar başına dakikada 300 istek alırsınız. Maksimum 8 eşzamanlı istek. İstek gövdesi boyutu 8 MB ile sınırlıdır.
HTTP durum kodlarını izleyin. 429 hız sınırının aşıldığını gösterir. 400 kötü isteği belirtir. 500 sunucu hatasıdır. Yeniden denemeler için üstel geri çekilme (exponential backoff) uygulayın. Bu, API'yi aşırı yüklemekten kaçınır.
Token kullanımını son akış parçasında izleyin. Bu, peşin kredinizi yönetmenize yardımcı olur. Hatalar token tüketmez. Bu, bakiyenizi korur. Düzenli izleme sorunsuz çalışma sağlar.
Maliyetleri ve Token Kullanımını Hesaplama
Fiyatlandırma şeffaf ve ön ödemelidir. Girdi tokenları milyon başına $0.15'tir. Çıktı tokenları milyon başına $0.50'dir. Kredi süresi dolmaz. Aylık ücret yoktur.
Yalnızca kripto ile bakiye yükleyin. USDT (TRC20) veya USDC (Base). Tutarlar $20 ile $500 arasındadır. Daha büyük yüklemeler için bonus kredi uygulanır. $50'den itibaren +%5, $100'den itibaren +%10, $200'den itibaren +%15.
Yoğun kullanımdan önce maliyetleri hesaplayın. İstemleriniz için token sayılarını tahmin edin. Bu, etkili bütçe planlamanıza yardımcı olur. Hatalar ücretsizdir. İadeler yapılmaz ancak hatalar düzeltilir. Harcamaları takip etmek için panoyu kullanın.
Sıkça sorulan sorular
Sansürsüzai.com OpenAI SDK'sı ile uyumlu mu?
Evet, API, tamamen OpenAI uyumludur. Python, Node.js ve diğer diller için standart OpenAI SDK'larını kullanabilirsiniz. Temel URL'yi HTTPS://api.uncensoredaicom.com/v1 olarak değiştirin ve API anahtarınızı iletin. Model kimliği "uncensored"dir. Aynı istek ve yanıt yapısını takip eder.
Hangi kripto ödemeler kabul ediliyor?
TRC20 ağı üzerinde USDT ve Base ağı üzerinde USDC kabul ediyoruz. $20 ile $500 arasında herhangi bir tam tutar yükleyebilirsiniz. Bonus kredi otomatik olarak eklenir: $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15.
Ön ödemeli kredi sona eriyor mu?
Hayır, ön ödemeli krediniz hiç sona ermez. Aylık abonelik ücreti veya kullanım son tarihi yoktur. Kullandığınız kadar ödersiniz ve hatalar krediden düşmez. Bu model, yalnızca gerçek değeri ödediğinizden emin olmanızı sağlar.
Bu API'yi NSFW içerik için kullanabilir miyim?
Evet, model sansürsüzdür ve yasal yetişkin, kurgusal veya çarpıcı konuları reddetmez. Sınırsız metin üretimi için tasarlanmıştır. Tek katı sınır, çocuklarla ilgili içeriktir ve her zaman reddedilir. NSFW sohbet botları ve yaratıcı yazım için idealdir.
API anahtarınızı oluşturun
Kaydolun, anahtarı alın, uç nokta adresini güncelleyin. Minimal yapılandırma gerekir.
