İçeriğe geç

Geliştiriciler için

Kodunun gönderdiği promptu çizen bir NSFW görsel API'si

NSFW bir görsel API'si, kendi yazılımından gelen yetişkin promptları alıp cümleyi önce yeniden yazmadan çizer; bu önemli, çünkü yeniden yazılmış bir prompt sessizce başarısız olur: çağrı başarılı döner, yanıt normal görünür ve görsel istediğin görsel değildir. Vellria kataloğunun tamamını tek bir REST biçiminin arkasında sunuyor: Bearer token'ları, yokladığın eşzamansız işler ve bir üretim düştüğünde kendiliğinden iade edilen ön ödemeli kredi.

Entegrasyonlar neden moderasyon katmanında kırılıyor

Çoğu görsel API'si göremediğin bir yeniden yazma adımının arkasında duruyor. Metnin sağlayıcının daha güvenli saydığı bir şeye dönüştürülüyor, dönüşmüş sürüm çiziliyor ve yanıtta bu değişimi bildiren bir alan bulunmuyor. Uygulamanın içinden bakınca her şey başarı bildiriyor; olabilecek en kötü hata biçimi de bu: yakalanacak bir şey yok, yeniden denenecek bir şey yok ve girdisine sessizce uymayan bir çıktı kuyruğu var.

İkinci hata, öngörülemeyen bir sıklıkla hata olarak gelen ret. Dün çalışan bir prompt bugün politika hatası döndürüyor, çünkü isteğin değil moderasyon modeli altından değişti. Yeniden denemek işe yaramıyor, hata belirlenimci değil ve ona karşı yazılan kod kimsenin yayımlamadığı bir sınır için özel durumlar biriktiriyor.

İkisi de bir hız sınırı ya da kesinti değil, yani normalde bakacağın yerlerin hiçbirinde görünmüyorlar. Kendi hattına duyduğun güvenin yavaşça erimesi olarak görünüyorlar ve olağan tepki, hiçbir zaman senin olmayan bir sorun için çıktıyı kötüleştiren savunmacı bir prompt-düzeltme katmanı.

Modeller

Vellria Lite Image

Katalogdaki en ucuz görsel modeli. Yalnız prompt: referans görsel almaz.

Metinden görsel

1 kredi

Seedream 5 Pro Image

Amiral gemisi görsel modeli; ayrıntı ve kompozisyon odaklı. Çıktı yalnız 2K.

Metinden görsel

8 kredi

Seedream 5 Pro Image Edit

Amiral gemisi düzenleme modeli. En çok on referans alır, kimliği ve ışığı korur.

Görselden görsel

8 kredi

Qwen 3 Image

Uzun ve karmaşık promptlarda güçlü; sahne kompozisyonuna ve metne sadık kalır.

Metinden görsel

5 kredi

Qwen 3 Image Edit

Verdiğin görselleri referans alarak düzenler, karakteri ve sahneyi korur.

Görselden görsel

5 kredi

Qwen 3 Pro Image

Qwen ailesinin üst fiyat kademesi. Yalnız prompt; her çıktı biçimi aynı tutar.

Metinden görsel

7 kredi

Qwen 3 Pro Image Edit

Qwen düzenlemesinin üst fiyat kademesi. İlkinden sonraki her görsel bedeli artırır.

Görselden görsel

7 kredi

Seedream 5 Lite Image

Hızlı ve ucuz Seedream. 4K çıkar; tipografi ve afiş işinde iyi.

Metinden görsel

5 kredi

Seedream 5 Lite Image Edit

En çok on dört referans alır ve verdiğin görselleri yeniden çizer.

Görselden görsel

5 kredi

Wan 2.6 Image

Yalnız prompt; çıktı biçimi ailenin en genişini de içeren kapalı bir listeden.

Metinden görsel

6 kredi

Wan 2.6 Image Edit

En çok dört referans görselden düzenler, hiçbiri bedeli artırmaz.

Görselden görsel

6 kredi

İstek biçimi

Anahtarlar konsolda üretiliyor ve Bearer olarak taşınıyor. Bir uç işi açıyor: modeli adlandır, promptu ver, o modelin aldığı ne varsa ekle. Geri gelen şey bir görsel değil bir kimlik — soket hemen kapanıyor, çünkü bir HTTP isteğinin içinde tutulan otuz saniyelik bir çizim, olmayı bekleyen bir zaman aşımıdır ve bunu deneyen her entegrasyon aynı dersi aldı.

Sonrasında işi beklemek yerine ona soruyorsun. O kimliğe atılan düz bir GET, işin nerede olduğunu söylüyor: hâlâ kuyrukta, çiziliyor, bitti ya da düştü. Bu çağrılar arasında sürecin ölüp yeniden başlayabilir ve hiçbir şey kaybolmaz, çünkü iş onu açan bağlantıya değil sunucuya ait.

Erken edinilecek bir alışkanlık var: model kimliklerini bir sabitler dosyasına yazmak yerine katalog ucuna neyin var olduğunu sor. O uç, sitenin kendisinin çizdiği ve defterin faturaladığı kaynak, yani bir şey değiştiği anda o da değişiyor. Sabit liste değişmiyor ve emekliye ayrılmış bir boyutu adlandıran reddedilmiş bir çağrıyla haftalar sonra öğreniyorsun.

Referans görseller ve hız sınırları

Düzenleme modellerinin üzerinde çalışacağı bir görsele ihtiyacı var ve görseller önce kendi ucundan geçiyor. Dosyayı gönder, dönen adresi sakla ve işi açarken o adresi adlandır. Adresi elinde tutan herkes oturum olmadan getirebiliyor — bilerek, çünkü çizimi yapan makine hesabının dışında yaşıyor ve baytları yine de okuması gerekiyor — ve adres, biten çıktıyı temizleyen saatle birlikte çalışmayı bırakıyor.

Katalog model türleri arasındaki çizgiyi bulanıklaştırmıyor. Referans modeline bakacak bir şey vermezsen reddediyor; yalnız metinle çalışan modele ek verirsen onu da reddediyor, yüklemeyi dekormuş gibi sayıp sessizce devam etmek yerine. Alternatifi, çizimin hiç açmadığı bir görselin faturasını sana kesmek ve bunu yaparken başarı bildirmek olurdu.

Kısıtlama hesap başına sayılıyor ve ret kaç saniye bekleyeceğini söylüyor. O sayı, yeniden deneme mantığının okuması için var; bir insanın olaydan sonra gözünü kısarak baktığı bir log satırından farklı bir tasarım hedefi.

Düşen işi cezalandırmayan faturalama

Defter işin sonunda değil başında hareket ediyor, çünkü iş o anda ısmarlanıyor. Bundan çıkan sonuç, otomatik çağıranların önemsemesi gereken kısım: sağlayıcının içinde ölen bir iş, düşmüş duruma vardığı anda kredisini doğrudan geri veriyor. Doldurulacak bir şey yok, e-posta atılacak kimse yok ve iki kayıt da mutabakatının bulabileceği yerde, geçmişte kalıyor.

Hesapta yenilenen hiçbir şey yok. Bir hafta yirmi çağrı atıp sonraki hafta hiç atmayan bir servis yirmi çağrının parasını ödüyor, çünkü altında taban toplayan bir plan yok. Kart ve kripto yüklemeleri farklı paketlerle geliyor ama paket bakiye alıyor, başka bir şey değil — hiçbir anahtar daha hızlı değil, hiçbir anahtar başka anahtarın ulaşamadığı modele ulaşmıyor.

Çıktı sonsuza kadar yaşamıyor, defter kaydı yaşıyor. Bir dosya süresini aşınca baytlar gidiyor ve kayıt kalıyor, yani görsel var olmayı bıraktıktan çok sonra bile maliyet sorgusu cevap veriyor. O noktadan sonra dosyayı istemek, çıplak bir bulunamadı yerine süresi dolmuş cevabı döndürüyor, çünkü öteki uçtaki kodun bir temizliği hatalı bir kimlikten ayırması gerekiyor.

Sınır, bir kez söylenmiş hâliyle

Promptu yeniden yazan bir şey yok ve açılan alan gerçekten geniş — kurgusal yetişkin iş dahil. Anahtardan, bakiyeden ve uçtan bağımsız olarak iki şey kapalı kalıyor: reşit olmayanlar (herhangi bir tasvirde) ve hiç rıza göstermemiş tanınabilir gerçek kişiler. İkisinden birini geç, hesap gider, anahtarlar da onunla.

İki kural, reddedilmiş çağrıların örüntüsünden öğrenmek yerine kendi ürününün içinde uygulayabileceğin kadar az. Kurallar sayfası politikanın tamamını taşıyor, API dokümanları da istek gövdelerini, durum kodlarını ve hata biçimlerini.

Sık sorulan sorular

API promptumu yeniden yazıyor ya da denetliyor mu?

Hayır. Kodunun gönderdiği metin, çizilen metin. Geriye kalan, tona ya da açıklığa değil yasak kategorilere bakan dar bir ret; ona takılan istek sessizce başkasıyla değiştirilmek yerine doğrudan reddediliyor, yani uygulaman onu çıktıda keşfetmek yerine hata olarak işleyebiliyor.

Eşzamanlı mı, yoksa yoklamam mı gerekiyor?

Yokluyorsun. Üretimi başlatmak hemen bir kayıt kimliği döndürüyor ve o kaydı terminal duruma varana kadar okuyorsun. Sürecin yeniden başlarsa ya da bağlantı düşerse hiçbir şey kaybolmuyor, çünkü iş onu oluşturan isteğin içinde değil sunucuda yaşıyor.

Üretim düştüğünde kredilerime ne oluyor?

Geri alma otomatik. Ücret iş açılırken alınıyor ve sağlayıcı tarafındaki bir başarısızlık, iş düşmüş duruma vardığı anda o ücreti geri veriyor. İki hareket de geçmişte görünüyor, yani aşağı akıştaki hiçbir şeyin elle bir fark kapatması gerekmiyor.

Koddan referans görsel gönderebilir miyim?

Evet, ayrı bir yükleme adımıyla. Dosya yukarı gidiyor, dönen adresi saklıyorsun ve o adres işi açarken görseli adlandırıyor. Getirmek için oturum gerekmiyor, çünkü çizen makine hesabının dışında; adres de biten çıktıyla aynı saatte eskiyor.

Yüksek hacim için ayrı anahtar ya da plan var mı?

Kademe yok. Anahtarlar konsoldan veriliyor ve her biri kataloğun tamamına aynı koşullarla ulaşıyor; hacim bir plan değil bakiye meselesi. Hız sınırları hesap başına uygulanıyor ve sınırı geçtiğinde yanıt ne kadar bekleyeceğini söylüyor.

Para harcamadan önce kataloğa bak

Abonelik yok. Kredi yükle, yalnız kullandığın kadar öde.

Bir model seç