Uncensored AI Entegrasyon Rehberi

Neden Sansürsüz Bir API'ye Geçmelisiniz?

Geliştiricilerin geçiş yapmasının birincil nedeni, yaratıcı iş akışlarını veya rol yapma senaryolarını kesen keyfi içerik reddetmelerini ortadan kaldırmaktır. Standart modeller genellikle aşırı agresif güvenlik ayarlamaları nedeniyle zararsız istekleri engeller. Sansürsüz bir API, yapay kısıtlamalar olmadan yanıtlamak üzere ayarlanmış tek bir model sunar. Bu yaklaşım, farklı istemler boyunca tutarlı davranış sağlar. Beklenmedik şekilde modelleri değiştirebilecek yönlendirilmiş bir proxy yerine özel bir uç nokta alırsınız. Faturalandırma ön ödemelidir, böylece tam olarak ne için ödeme yaptığınızı bilirsiniz. Aylık abonelikler veya gizli ücretler yoktur. Hatalar kredinizi tüketmez. Bu şeffaflık, tahmin edilebilir maliyetlere ihtiyaç duyan bütçe bilincine sahip geliştiriciler için kritiktir. Birden fazla model uç noktasını yönetmenin karmaşıklığından kaçınırsınız. Tek model odaklılık, istemlerinizi tek bir belirli davranış desenine göre optimize etmenizi sağlar. Bu, sorunlar ortaya çıktığında hata ayıklama süresini azaltır. Çıktı stili ve içerik sınırları üzerinde tam kontrolü korursunuz.

Ortamınızın Kurulumu

Tercih ettiğiniz dil için resmi OpenAI SDK'sını yükleyerek başlayın. Bu, standart uç nokta yapılarıyla uyumluluğu sağlar. API anahtarınızı oluşturmak için yeni bir hesap oluşturun. Süreç için yalnızca bir e-posta adresi veya Google girişi gerekir. Temel erişim için telefon numarası doğrulaması gerekmez. Uç noktamızı test etmek için hemen bir deneme kredisi alırsınız. Anahtar bir kez gösterilir ve güvenli bir şekilde saklanmalıdır. Anahtarınızı sürüm kontrolünden uzak tutmak için ortam değişkenlerini kullanın. Bu, üretim dağıtımları için standart bir uygulamadır. SDK, anahtarı geçtiğinizde kimlik doğrulamasını otomatik olarak yönetir. Başlık yapısını manuel olarak değiştirmenize gerek yoktur. İstemci kütüphanesi HTTP isteklerini verimli bir şekilde yönetir. Bu kurulum hem yerel geliştirme hem de bulut sunucuları için çalışır. Yetkisiz kullanımı önlemek için anahtarınızı güvenli tutun. Deneme kredisi, daha fazla satın almadan önce bağlantıyı doğrulamanıza olanak tanır.

Temel URL'yi Yapılandırma

İstemcinizi sansürsüz hizmet için özel temel URL'ye yönlendirin. Bu URL, yapılandırmanızdaki varsayılan OpenAI uç noktasının yerini alır. SDK istemci örneğinizin temel URL alanını güncellemeniz gerekir. Standart model kimliği "uncensored" olarak ayarlanmıştır. Bu, sunucuya hangi özel modelin çalıştırılacağını belirtir. Uç nokta standart sohbet tamamlama parametrelerini destekler. Rastgeleliği kontrol etmek için sıcaklık ve top_p değerlerini ayarlayabilirsiniz. Bağlam penceresi toplamda 100,000 tokene kadar destekler. Bu, uzun konuşmalar veya büyük belge işleme için olanak sağlar. Çıktı, istek başına 16,000 token ile sınırlıdır. Gerekli formatta standart mesajlar gönderebilirsiniz. API, model eğitimiyle tutarlı metin yanıtları döndürür. Geri bildirim için gerçek zamanlı akış varsayılan olarak etkindir. Bu yapılandırma mevcut kod tabanlarıyla uyumluluğu sağlar. Tüm entegrasyon mantığınızı yeniden yazmanıza gerek yoktur. Geçiş minimaldir ve büyük ölçüde otomatiktir.

İlk İsteğinizi Yapmak

Kurulumu doğrulamak için basit bir sohbet tamamlama isteği gönderin. Kullanıcı istemiyle standart mesaj formatını kullanın. Yanıt oluşturulan metni doğrudan içerecektir. Yanıt meta verilerindeki token kullanımını kontrol edin. Bu, faturalandırmanın kullanımınızı doğru şekilde takip ettiğini doğrular. Model, yasal yetişkin içeriğe reddiyede bulunmadan yanıt verir. Farklı tonları ve stilleri hemen test edebilirsiniz. Uç nokta, tahminleme işlemini özel sunucularda gerçekleştirir. Sonucu standart bir HTTP yanıtı olarak alırsınız. Temel metin üretimi için ek başlık gerekmez. Süreç, herhangi bir OpenAI-uyumlu servise çağrı yapmakla aynıdır. Bu tutarlılık, yeni ekipler için öğrenme eğrisini azaltır. Bunu mevcut uygulamalarınıza hızlıca entegre edebilirsiniz. Ön ödemeli kredi, yalnızca başarılı token üretimi için düşülür. Başarısız istekler bakiyenizi tüketmez. Bu da testleri maliyet etkin ve öngörülebilir kılar.

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

Oluşturulurken belirteçleri almak için akış özelliğini etkinleştirin. Bu, etkileşimli uygulamalar için kullanıcı deneyimini iyileştirir. Sunucu, kısmi yanıtları Sunucu Tarafından Gönderilen Olaylar (SSE) aracılığıyla gönderir. İstemciniz bu olayları ayrıştırarak metni kademeli olarak görüntüler. Son parça, toplam belirteç kullanım ayrıntılarını içerir. Bu, maliyetleri gerçek zamanlı olarak takip etmenizi sağlar. Akış, son kullanıcılar için algılanan gecikmeyi azaltır. Kullanıcı yazmayı durdurursa üretimi durdurabilirsiniz. SDK, olay ayrıştırmayı otomatik olarak yönetir. Bağlantıyı manuel olarak yönetmenize gerek yoktur. Akış, ağ kesintilerinden sonra sorunsuz bir şekilde devam eder. Bu özellik, sohbet arayüzleri için temel öneme sahiptir. Daha dinamik ve etkileyici bir etkileşim sağlar. Model metni belirteç belirteç üretir. Bu yaklaşım, modern LLM uygulamaları için standarttır. Akışı, karmaşık görevler için işlev çağırma ile birleştirebilirsiniz. Veri akışı verimli ve güvenilirdir.

Fonksiyon Çağırma Kullanımı

Araç kullanımını etkinleştirmek için fonksiyon şemalarını istek yükünde tanımlayın. Model, koşullar karşılandığında yapılandırılmış veri döndürür. Farklı görevler için birden fazla araç belirtebilirsiniz. API hem tool_choice hem de otomatik seçimi destekler. Bu, model davranışı üzerinde hassas kontrol sağlar. Şemanıza uyan JSON çıktısı alırsınız. Hata yönetimi yanıt formatına dahildir. Fonksiyonu çalıştırmadan önce çıktıyı doğrulayabilirsiniz. Bu, otomatik iş akışları ve ajanlar için hayati önem taşır. Model fonksiyon açıklamalarını net anlar. Serbest metni manuel olarak ayrıştırmaya gerek kalmaz. Yapı, farklı prompt'lar arasında tutarlılık sağlar. Farklı bağlamlar için şemaları dinamik olarak güncelleyebilirsiniz. Bu özellik karmaşık çok adımlı süreçleri destekler. API, araç sonuçlarının modele yönlendirilmesini yönetir. Karar sürecinin tam görünürlüğünü korursunuz.

Token'ları ve Maliyetleri Yönetme

Ön ödemeli bütçeniz dahilinde kalmak için token kullanımınızı izleyin. Giriş token'ları milyon başına $0.15 ücretlendirilir. Çıktı token'ları milyon başına $0.50 ücretlendirilir. Fark, üretim için hesaplamalı maliyeti yansıtır. Büyük istekler göndermeden önce maliyetleri hesaplayabilirsiniz. API, her yanıtta token sayılarını döndürür. Bu, giderlerin doğru tahminine olanak tanır. Hatalar ve reddetmeler ücretsizdir, bu nedenle yalnızca değer için ödeme yaparsınız. Aylık ücret veya abonelik kilidi yoktur. İstediğiniz zaman kripto ile yeniden yükleyebilirsiniz. Kredi süresi dolmaz, bu nedenle kullanımı duraklatabilirsiniz. Bu esneklik, değişken talebi olan projeler için idealdir. Boşta kapasite için ödeme yapmaktan kaçınırsınız. Ön ödemeli model şeffaflık ve kontrol sağlar. Harcadığınızdan önce tam olarak ne harcadığınızı bilirsiniz. Bu, bütçe odaklı geliştiriciler için özellikle yararlıdır.

Yaygın Ollama vs API Soruları

Ollama modelleri makinenizde yerel olarak çalıştırır ve kendi donanımınızı gerektirir. API modelleri uzak sunucularda çalıştırır ve yalnızca bir internet bağlantısı gerektirir. Yerel çıkarım, GPU ve RAM kapasitenize bağlıdır. API, cihazınızdan bağımsız olarak tutarlı performans sağlar. Model indirmeleri veya güncellemeleriyle ilgilenmenize gerek yoktur. API, çoğu yerel kurulumdan daha büyük bir bağlam penceresi destekler. Donanımınızı yükseltmeden kullanımı ölçeklendirebilirsiniz. API, yüksek çalışma süresi gereksinimleri olan üretim ortamları için daha iyidir. Yerel Ollama, gizlilik duyarlı veya çevrimdışı kullanım için idealdir. Seçiminiz altyapınıza ve gecikme gereksinimlerinize bağlıdır. Her iki yaklaşım da aynı temel model mimarisini hizmete sunar. API, mevcut bulut hizmetleriyle daha kolay entegrasyon sunar. Yerel bağımlılıkları yönetmenin karmaşıklığından kaçınırsınız. Seçim, spesifik dağıtım kısıtlamalarınıza bağlıdır.

Kotasında Sorun Giderme

Her anahtar başına dakikada 300 istekle sınırlısınız. Bunu aşarsanız API 429 hatası döndürür. Üstel geri çekme ile yeniden deneme mantığı uygulamalısınız. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. Bu, paralel görevlerle sunucuyu aşırı yüklemeyi önler. İhtiyaçlarınıza göre eşzamanlılığı ayarlayabilirsiniz. Limit anahtar başına olduğundan ek anahtarlar oluşturabilirsiniz. Her hesap aynı anda tek bir aktif anahtar destekler. Yeni bir limit almak için eski anahtarı değiştirin. İstek gövdesi boyutu 8 MB ile sınırlıdır. Büyük girdiler bu limiti aşabilir. Verileri gerekliyse daha küçük parçalara bölün. Kullanımınızı izlemek limitler içinde kalmanıza yardımcı olur. API, hata ayıklama için açık hata mesajları sağlar. Uygulama yükünüze göre hızınızı ayarlayabilirsiniz. Bu, yoğun zamanlarda kararlı performansı sağlar. Tıkanıklıktan kaçınmak için trafiğinizi planlayın.