Filtresiz AI Sohbet: Adım Adım Entegrasyon Rehberi

Filtresiz AI Sohbet'in Geliştiriciler İçin Neden Önemli Olduğu

Rol yapma uygulamaları oluşturan geliştiriciler genellikle, kullanıcı deneyiminin içgüselliğini bozan sessiz reddetmelerle karşılaşır. Standart modeller, katı politika ihlallerinden ziyada belirsiz 'vibe' kontrollerine dayanarak içerik kalitesini düşürebilir veya istekleri engelleyebilir. Filtresiz bir AI sohbet çözümü, bu keyfi kapıcıları kaldırır ve uygulamanızın sürtünme olmadan çeşitli, olgun veya tartışmalı konuları ele almasını sağlar. Tutarlılığın genel güvenlikten daha önemli olduğu içerik veri hatları için bu güvenilirlik kritiktir.

Altyapımız, yetişkin ve kısıtlamasız içerik için istekleri sunmak üzere özel olarak hazırlanmıştır. Trafiğinizi 'NSFW' olduğu için aşağı sıralamıyoruz. Bunun yerine, gizli bir denetim katmanına göre değil, bağlama dayalı olarak soruları yanıtlayan ve hikayeler üreten sansürsüz bir modele doğrudan bir yol sağlıyoruz. Bu yaklaşım, kullanıcılarınınızın özel sohbet botlarından beklediği ham, işlenmemiş yaratıcılığı elde etmelerini sağlar.

Ortamınızın Kurulumu

Tercih ettiğiniz dil için resmi OpenAI SDK'sını yükleyerek başlayın; API'miz standart chat-completions protokolünü izler. API anahtarınızı güvenli bir şekilde saklamak için ortam değişkenlerinizi yapılandırmanız gerekecektir. Kurulum süreci, mevcut endüstri standartlarına dayandığımız için basittir.

Kütüphaneyi paket yöneticiniz aracılığıyla yükleyin. Python için pip install openai, Node.js için npm install openai kullanın. Yüklendikten sonra istemciyi içe aktarın ve temel URL ile başlatın. Bu adım, tüm sonraki çağrıların sunucularımıza doğru şekilde yönlendirilmesini sağlar. Anahtarınızı gizli tutun ve bir proxy kullanmıyorsanız istemci tarafı kodunda asla ortaya çıkarmayın.

Temel URL'yi Yapılandırma

İstemcinizi sansürsüz uç noktaya erişmek için HTTPS://api.storyunfiltered.com/v1 adresine yönlendirin. Bu temel URL, SDK yapılandırmanızdaki varsayılan OpenAI uç noktasının yerini alır. Bu tek değişkeni değiştirerek uygulamanızı standart GPT modellerinden özel sansürsüz büyük dil modelimize geçirirsiniz. İsteklerde belirtmeniz gereken model kimliği "uncensored"dir. Bu tanımlayıcı, trafiğinizi hangi özel örneğe yönlendireceğini sunucuya söyler.

Yapılandırmayı basit bir test isteği göndererek doğrulayın. Modelin mevcut olduğunu onaylamak için GET /v1/models uç noktasını kontrol edin. Yanıt, "uncensored" modelinin mevcut olduğunu listelemelidir. Bu doğrulama adımı, karmaşık özellikler geliştirmeye başlamadan önce ortamınızın doğru şekilde bağlandığından emin olmanızı sağlar. Ayrıca oluşturduğunuz API anahtarının aktif olduğunu ve ön ödemeli kredinizle ilişkili olduğunu doğrular.

API Anahtarınızla Kimlik Doğrulama

API anahtarınızı Authorization başlığında Bearer token olarak iletin. Google girişi veya e-posta ve şifre ile anahtar oluşturma destekliyoruz. Anahtar oluşturulduktan hemen sonra görüntülenir, bu nedenle onu ortam değişkenlerinize kopyalayın. Her hesabın tek bir aktif anahtarı vardır; yeni bir anahtar oluşturmak önceki anahtarı anında değiştirir. Bu, anahtar rotasyonunu basitleştirir ve sistemlerinizde eski kimlik bilgilerinin kalma riskini azaltır.

Kayıt için telefon numarası gerekmez ve gizlilik yalnızca e-postanızı saklayarak korunur. İstemler (prompts), verilerinizi eğitim için kullanılmak üzere kaydedilmez; bu da kurumsal veya gizlilik odaklı uygulamalar için kritiktir. Anahtar süresi dolmaz, ancak ona bağlı ön ödemeli kredinin de belirli bir son kullanma tarihi yoktur. Hatalar ve reddetmeler bakiyenizi tüketmez, bu nedenle beklenmedik ücretlerden endişelenmeden özgürce test edebilirsiniz.

İlk İsteğinizi Gönderme

Modeli "uncensored" olarak ayarlayarak /v1/chat/completions uç noktasına standart bir POST isteği oluşturun. Kişiliği tanımlamak için sistem isteminizi ekleyin ve konuşmayı ilerletmek için kullanıcı mesajlarını ekleyin. Bağlam penceresi, istem ve tamamlama için birlikte 100,000 tokenı destekler. Bu, büyük belgeleri veya uzun konuşma geçmişlerini anında kısaltma olmadan iletmenize olanak tanır. Yükünüzün 8 MB istek gövdesi sınırının altında kaldığından emin olun.

Yaratıcılığı kontrol etmek için sıcaklık ve top_p parametrelerini ayarlayın. Daha yüksek bir sıcaklık, daha çeşitli çıktılar üretir ki bu da rol yapma için idealdir. Daha düşük bir sıcaklık, gerçekçi veya yapılandırılmış görevler için tutarlılığı sağlar. Model, veri çıkarma görevleri için yapılandırılmış çıktılar zorlamak amacıyla response_format aracılığıyla JSON modunu destekler. Bu esneklik, API'yi hem günlük sohbet hem de üretim düzeyinde entegrasyonlar için uygun kılar.

Akış Yanıtlarını İşleme

İsteğinizde stream'i true olarak ayarlayarak akışı etkinleştirin. API, oluşturuldukları gibi kısmi yanıtları içeren Sunucu Tarafı Olayları (SSE) döndürür. Bu, son kullanıcılar için algılanan gecikmeyi iyileştirir, böylece uzun çıktılar için bile sohbet duyarlı hissedilir. Her parça, uygulamanızın nihai yanıtı oluşturmak için birleştirmesi gereken delta içerik içerir.

Akıştaki son parça token kullanım verilerini içerir. Bu verileri kredi tüketiminizi doğru şekilde takip etmek için kullanın. 1M girdi tokenı başına $0.15 ve 1M çıktı tokenı başına $0.50 ücretlendirilirsiniz. Faturalandırma gerçek kullanıma dayalıdır, bu nedenle kısmi yanıtlar orantılı olarak ücretlendirilir. Bu şeffaflık, maliyet kontrollerini doğrudan uygulama mantığınıza uygulamanıza olanak tanır.

Araç Çağırma Uygulama

API'miz, modelin kullanıcı niyetine göre dış araçları çağırmasını sağlayan işlev çağırma destekler. İşlevlerinizi tools parametresinde bir ad, açıklama ve parametre şeması ile tanımlayın. Model, bir işleve ihtiyaç duyulduğunu belirlerse tool_calls içeren bir yanıt döndürecektir. Ardından işlevi yürütmeniz ve sonucu bir sonraki mesajda göndermeniz gerekir.

Bu özellik, hava durumu aramaları, veritabanı sorguları veya web kazıma gibi karmaşık iş akışlarını mümkün kılar. Uncensored model, araç tanımlarını standart modellerle aynı hassasiyetle işler. Ancak, gömme veya ince ayar sunmadığımıza dikkat edin. Uygulamanız vektör aramasına veya özel model eğitimine dayanıyorsa, bu API doğru seçim olmayabilir. En iyi sonuçlar için doğrudan sohbet-tamamlamaları kullanın.

Maliyet ve Hız İçin Optimizasyon

Ön ödemeli kredinizin kullanımını, gereksiz API çağrılarını minimize ederek maksimize edin. Test sırasında deterministik çıktılar için seed parametresini kullanın. Modelin bakiyenizi aşırı uzun yanıtlar üreterek tüketmesini önlemek için max_tokens sınırını ayarlayın. Varsayılan çıktı limiti 2,048 token'dır ancak isteğe bağlı olarak istek başına 16,000 token'a kadar artırabilirsiniz. Bu, tek bir çağrıda uzun hikayeler veya detaylı raporlar oluşturmak için faydalıdır.

Dakikada 300 istek sınırında kalmak için istek hızını izleyin. Bunu aşarsanız 449 hatası alırsınız. Yeniden denemeleri zarifçe yönetmek için istemci kodunuzda üstel geri çekilme uygulayın. Hatalar ücretsiz olduğundan, başarısız istekleri ceza ödemeden yeniden deneyebilirsiniz. Bu güvenlik ağı, yoğun kullanım dönemlerinde bile güvenilirliği sağlar.

Yaygın Hataları Halletmek

401 hatası alırsanız API anahtarınızın doğru ve aktif olduğunu doğrulayın. Temel URL'nin HTTPS://api.storyunfiltered.com/v1 ile tam olarak eşleştiğinden emin olun. 404 hatası genellikle uç nokta yolundaki bir yazım hatasını gösterir. Sohbet tamamlamalar için doğru HTTP yöntemini, yani POST'u kullandığınızdan emin olun. Hata devam ederse anahtarınızı panelden yeniden oluşturun.

429 hatası, dakikada 300 istek hız sınırını aştığınızı gösterir. Pencerenin sıfırlanmasını bekleyin veya istek sıklığınızı azaltın. Bir 413 hatasıyla karşılaşırsanız, istek gövdeniz 8 MB sınırını aşar. Yükünüzü basitleştirin veya bağlam penceresi boyutunu azaltın. Bu hatalar REST API'ler için standarttır ve dikkatli hata ayıklama ile çözülebilir.