Sansürsüz API SSS: Kayıt, Faturalandırma, Uç Noktalar, Hata Kodları ve İçerik Sınırları
Geliştiricilerin sansürsüz API'yi kullanırken sorduğu en sık soruları; kayıt, deneme kredisi, faturalandırma, uç noktalar, hata kodları, içerik sınırları ve gizlilik olarak altı kategoride topladık. Uç noktalar OpenAI formatıyla uyumludur ve tek bir uncensored modeli mevcuttur. Token başına ön ödemeli faturalandırma yapılır. Kod örneklerini görmek için Kod Örnekleri sayfasına, tüm parametreleri öğrenmek için Dokümantasyon sayfasına göz atabilirsiniz.
Güncelleme tarihi:
Önemli Noktalar
- Kayıt için e-posta ve şifre yeterlidir, kart gerekmez. Yeni hesaplara $0.50 deneme kredisi verilir, 7 gün geçerlidir.
- Fiyatlar: Girdi $0.25, Çıktı $1.00 / milyon token. Ön ödemeli, bakiye süresi dolmaz.
- Bağlam 100,000 token. max_tokens varsayılan 2048, maksimum 32,000. Anahtar başına dakikada 300 istek.
- Küçük yaşlı cinsel içerikler her zaman engellenir; yalnızca yetişkinler ve yasal kullanım için; istemler eğitim için kullanılmaz.
Kayıt ve Ücretsiz Deneme
Nasıl kayıt olunur, banka kartı bağlamak gerekli mi?
/get-api-key/ sayfasında e-posta ve şifre ile kayıt yapmanız yeterlidir, kart bağlamanıza gerek yoktur. Kayıt tamamlandığında anahtarınız hemen ekranda görünür, onay beklemenize gerek kalmaz.
Yeni hesaplarda ne kadar deneme kredisi vardır, ne kadar süre geçerlidir?
Yeni hesaplara $0.50 deneme kredisi verilir, 7 gün geçerlidir. Çıktı fiyatı $1.00 / milyon token olduğunda, bu yaklaşık 500.000 token'lık yanıt üretmenizi sağlar; entegrasyon testi ve küçük ölçekli doğrulama için yeterlidir.
Bir hesapta kaç anahtar bulunabilir? Anahtar kaybolursa ne olur?
Her hesabın yalnızca bir anahtarı vardır. Sızması veya kaybolması durumunda hesabınızdan yenisiyle değiştirebilirsiniz; eski anahtar hemen geçersiz olur. Eski anahtarı kullanan tüm hizmetler 401 hatası alır, bu nedenle anahtar değiştirdikten sonra ortam değişkenlerinizi güncelleyin.
Deneme süresi dolduğunda ne olur?
Deneme kredisi süresi dolduğunda istekleriniz 402 hatası döndürür ve hata kodu no_credit olur. Kullanıma devam etmek için hesabınıza ön ödemeli bakiye yüklemeniz yeterlidir, kod tarafında değişiklik yapmanıza gerek yoktur.
Faturalandırma ve Bakiye
Fiyatlar nedir, nasıl faturalandırma yapılır?
Token başına faturalandırma: Girdi $0.25 / milyon token, Çıktı $1.00 / milyon token. Abonelik veya aylık ücret yoktur; kullandıkça ödersiniz. Detaylar için Fiyatlandırma sayfasına bakınız.
Bakiye süresi dolar mı?
Hayır. Yüklenen ön ödemeli bakiyenin süresi dolmaz. Yalnızca yeni hesaplara verilen $0.50 deneme kredisi 7 günlük bir süreye sahiptir.
Bir istek için ne kadar ödeme yaptığımı nasıl öğrenebilirim?
Her yanıtın usage alanı, bu istek için girdi ve çıktı token sayılarını verir. Birim fiyatla çarparak maliyeti hesaplayın. Akış isteklerinde son veri bloğu da usage içerir; okurken bu bloğun choices alanının boş bir dizi olduğunu unutmayın.
Beklenmedik yüksek faturaları nasıl önleyebilirim?
Bunu iki yolla yapın: max_tokens ile tek seferlik çıktıyı sınırlayın (varsayılan 2048); çoklu diyaloglar için geçmiş metni kısaltın, girdi çok uzamasın. Ön ödemeli olduğundan, bakiye bittiğinde istekler durur ve bakiyenin üzerinde fatura oluşmaz.
Örnek olarak, normal bir istek yaklaşık ne kadar tutar?
Girdi 2.000 token, çıktı 500 token varsayalım: Girdi yaklaşık $0,0005, çıktı yaklaşık $0,0005, toplam yaklaşık $0,001; bu da bin istek için yaklaşık $1 eder. Gerçek sayılar, yanıtın usage alanına dayanmalıdır.
Bakiye bittiğinde ne olur?
Uç nokta 402 hatası döndürür ve hata kodu no_credit olur. Bakiye yükledikten sonra kullanmaya devam edebilirsiniz, anahtarınızı yeniden oluşturmanıza gerek yoktur.
Uç Noktalar ve Parametreler
Uç nokta adresi ve model adı nedir?
Base URL https://api.wuxianzhiapi.com/v1 şeklindedir. Model adı sabit olarak uncensored olarak yazılmalıdır. Kullanılabilir uç noktalar POST /v1/chat/completions ve GET /v1/models'dir.
OpenAI SDK'ları ile uyumlu mu?
Uyumlu. Resmi Python openai v1+ ve npm openai v4+ ile, base_url ve anahtarı değiştirerek kullanabilirsiniz. Detaylar için kod örnekleri'ne bakın; diğer uç noktalardan geçiş için geçiş kılavuzu'ne bakın.
Bağlam penceresi ne kadar uzun? max_tokens ne kadar ayarlanabilir?
Bağlam penceresi 100.000 token'dır; istem ve çıktı birleşik bu sayıyı aşamaz. max_tokens varsayılan olarak 2048'dir, tek istek için maksimum 32.000 token. İstek gövdesi 8 MB'ı geçemez.
Akış (streaming) ve fonksiyon çağırma destekleniyor mu?
İkisi de desteklenir. Akış için stream: true kullanın; sunucu yanıtın sonuna otomatik olarak usage içeren bir veri bloğu ekler. Fonksiyon çağırma için OpenAI formatında tools ve tool_choice kullanılır. Araç sonuçları role: "tool" mesajı olarak iletilir.
Neden akış yanıtının son bloğunda metin yok?
Bu, otomatik eklenen kullanım istatistikleri bloğudur; choices boş bir dizidir, usage alanı bu istek için token sayısını içerir. İçeriği almadan önce choices'un boş olup olmadığını kontrol ederseniz, dizin sınırlaması hatası almazsınız.
Hız limiti var mı?
Her anahtar için dakikada 300 istek. Limiti aşarsanız 429 döner, bekleterek yeniden deneyin; üstel geri çekilme önerilir.
Vektörler, resimler, ses veya ince ayar destekleniyor mu?
Hiçbiri desteklenmez. Yalnızca metin diyalogu sağlıyoruz; uncensored modeli dışında başka modelimiz yok, embeddings desteği yok; resim, ses, video üretimi ve ince ayar da yok.
Hata kodları
Tüm hata yanıtları JSON formatındadır ve {"error":{"code":...,"message":...}} formatını izler. Aşağıda, durum kodlarına göre her birinin nasıl işleneceği tek tek açıklanmıştır.
400 hatası nedir?
İstekin kendisinde bir sorun vardır. En yaygın neden, istem ile max_tokens değerinin 100,000 token sınırını aşması veya JSON formatının hatalı olması, alan türlerinin yanlış olmasıdır. İsteği düzeltmeniz gerekir; yeniden denemek işe yaramaz.
401 hatası nasıl giderilir?
Geçersiz anahtar veya eksik. İstek başlığının Authorization: Bearer <anahtar> olup olmadığını, ortam değişkenlerinin geçerli olup olmadığını, anahtarın yeniden oluşturulup oluşturulmadığını kontrol edin; anahtar yeniden oluşturulduğunda eski anahtar hemen geçersiz hale gelir.
402 no_credit hatası ne anlama gelir?
Bakiye bitti veya deneme kredisi süresi doldu. Hesabınıza bakiye yükleyerek devam edebilirsiniz, anahtar değiştirmenize gerek yok.
403 content_blocked hatası ne anlama gelir?
İstek içerik engellemesini tetikledi. Küçük yaşlı cinsel içerikler her zaman engellenir; kurgusal ve rol yapma içerikler de dahil, bu ayarlanamaz. İsteğinizi değiştirerek yeniden deneyin; aynı isteği tekrar gönderirseniz sonuç değişmez.
404 hatası neden oluşur?
Mevcut olmayan bir uç noktaya erişildi. Yaygın neden URL'nin yanlış yazılmasıdır (örneğin /v1 eksik) veya desteklenmeyen bir uç noktanın çağrılması (embeddings ve resim üretimi gibi).
429 ve 503 hataları nasıl işlenir?
429 hatası, dakikada 300 isteklik hız limitinin aşıldığını gösterir; 503 hatasının kodu upstream_busy olup, modelin geç olarak meşgul olduğunu belirtir. Birkaç saniye sonra yeniden deneyin. Her iki durum için de üstel geri çekilme ile yeniden deneme uygundur; örnekler için kod örnekleri sayfasına bakın.
İçerik sınırları
"Sansürsüz" olmak her şeyi üretebileceği anlamına mı gelir?
Hayır. Yasal yetişkin içerikleri, kurgusal eserler ve tartışmalı konular reddedilmez; ancak küçük yaşlı cinsel içerikler her zaman engellenir ve 403 hatası döndürülür; kurgusal olup olmamasına veya rol yapma içerik olup olmamasına bakılmaksızın. Kullanım yasal olmalıdır.
Bu hizmet hangi kullanıcılar içindir?
Yalnızca 18 yaşından büyük yetişkinler için. Son kullanıcıya yönelik bir ürün için kullanıyorsanız, kendi uygulamanızda yaş doğrulaması yapmalı ve şikayet ile hesap yönetimi mekanizmalarını korumalısınız.
Rol yapma, roman veya oyun için kullanılabilir mi?
Evet, bu en tipik kullanım alanıdır. Farklı senaryolar için istem örnekleri ve maliyet tahminleri uygulama alanları makalesinde yer almaktadır.
Rol yapma sırasında hangi durumlarda 403 hatası döndürülür?
Yalnızca içerik filtrelemesi tetiklendiğinde 403 hatası döndürülür; bu durum genellikle ergin olmayanlara yönelik cinsel içerik (kurgusal ayarlar dahil) söz konusu olduğunda gerçekleşir. Yetişkinler arasındaki yasal içerikler rol yapma nedeniyle reddedilmez. 403 hatası aldığınızda, karakter veya hikaye ayarlarını değiştirip yeniden deneyin.
Modelin ürettiği bilgiler her zaman doğru mudur?
Her zaman değil. İçeriğin reddedilmemesi içeriğin doğru olduğu anlamına gelmez. Gerçeklik, veri, hukuk veya tıp ile ilgili sonuçlar için kullanmadan önce kendi doğrulamanızı yapmalısınız.
Gizlilik
Gönderdiğim istemler model eğitimi için kullanılır mı?
Hayır. Gönderdiğiniz istemler eğitim için kullanılmaz.
Anahtarı nasıl korumalıyım?
Anahtarı sunucu ortam değişkenlerinde tutun; ön yüz sayfalarında, mobil uygulama paketlerinde veya açık kaynak kod depolarında yazmayın. Sızıntı şüphesi oluşursa, hesabınızdan hemen yenisiyle değiştirin; eski anahtar hemen geçersiz olur.
Uygulamadaki kullanıcı verileri nasıl işlenmelidir?
Bu kısım kendi ürününüze bağlıdır. Görevi tamamlamak için gerekli olan içeriği göndermeniz önerilir; kullanıcıların gerçek adlarını, kimlik numaralarını, iletişim bilgilerini gibi hassas bilgileri isteme eklemeyin ve kendi gizlilik politikalarınızda verilerin nasıl işlendiğini açıkça belirtin.
Sıkça Sorulan Sorular
Kayıt için banka kartı gerekli mi? Deneme kredisi ne kadar?
Kart bağlamanıza gerek yok; e-posta ve şifre ile kayıt olduktan sonra anahtarınız hemen görünür. Yeni hesaplara $0.50 deneme kredisi verilir, 7 gün geçerlidir.
Fiyatlandırma nasıl çalışır? Bakiye süresi dolar mı?
Girdi $0,25 / milyon token, çıktı $1,00 / milyon token. Ön ödemeli, abonelik ve aylık ücret yok. Yüklenen bakiye asla sona ermez; yalnızca deneme kredisi 7 gün ile sınırlıdır.
Bağlam penceresi uzunluğu ve max_tokens üst limiti nedir?
Bağlam penceresi 100,000 token'dir (istem ve çıktı toplamı). max_tokens varsayılan olarak 2048'dir; tek istekte maksimum 32,000 token gönderilebilir. İstek gövdesi 8 MB'ı geçmemelidir. Her API anahtarı için dakikada 300 istek sınırı vardır.
402 veya 403 hatası neden döndürülür?
402 hatasının kodu no_credit olup, bakiyenin tükenmiş veya ücretsiz deneme kredisinin süresinin dolmuş olduğunu gösterir; bakiye yükleyerek sorunu çözebilirsiniz. 403 hatasının kodu content_blocked olup, ergin olmayanlara yönelik cinsel içerikler her zaman filtrelenir; bu durum kurgusal içerikler için de geçerlidir.
İstemler eğitim için kullanılır mı?
Hayır, istemler eğitim için kullanılmaz.
Anahtarı almak için yalnızca formu doldurmanız yeterlidir
Hesap oluşturun, API anahtarını kopyalayın ve Base URL'i düzenleyin. Yapılandırma bu kadar basittir.
API anahtarını alın