Picverse AI, görüntü düzenleme araçları ve üretim modelleri için herkese açık API'yi kullanıma sundu

Neler çıktı

Web'de iki dilli (İngilizce ve İspanyolca) bir görüntü stüdyosunun arkasındaki ekip Picverse AI, görüntü düzenleme araçlarını ve metinden görüntüye üretim modellerini dış backend'lere açan 1.0.0 sürümlü herkese açık bir API yayınladı. dev.to'daki duyuru yazısına göre servis api.picverse.com adresinde barındırılıyor ve hem makine tarafından okunabilir bir OpenAPI sözleşmesi hem de insan tarafından okunabilir bir dokümantasyonla geliyor; API anahtarları hesap panosundan oluşturuluyor.\n Yazıya göre API yüzeyi, iş ortaklarından gelen dört yinelenen talebe göre şekillendirilmiş: tarayıcı JavaScript'inde değil sunucuda kalan anahtarlar, yavaş bir modelin çağıranın HTTP timeout'ını tetiklememesi için asenkron job'lar, web sitesiyle API arasında paylaşılan tek bir kredi bakiyesi ve her aracı ve modeli tanımlayan, keşfedilebilir kataloglar.

Kimlik doğrulama, planlar ve krediler

Kimlik doğrulama, pk_live_ veya pk_test_ önekli bearer anahtarlarla yapılıyor. Anahtarlar bilinçli olarak sunucu tarafına yönelik: gateway hiçbir CORS header'ı göndermiyor, dolayısıyla frontend JavaScript'ine gömülmüş bir anahtar tarayıcı sayfasından çalışmayacak. Bir hesap en fazla 10 aktif anahtar tutabilir ve iptal edilen anahtarlar geçmişte kalır, böylece eski job kayıtları yorumlanabilir olmaya devam eder.

Erişim ücretli kullanımın arkasına yerleştirilmiş. Yazıya göre anahtar oluşturmak veya kimlik doğrulaması gerektiren rotaları çağırmak aktif bir Basic, Standard veya Premium planı ya da satın alınmış bir kredi paketi gerektiriyor; yalnızca ücretsiz bir hesap, plan yükseltme kodu içeren bir 403 hatası alıyor.

İşleme, önce-oluştur-sonra-poll deseni izliyor. Bir idempotency key header'ını destekleyen jobs endpoint'ine yapılan bir POST, hemen bir job tanımlayıcısı döndürüyor ve istemciler job, succeeded veya failed durumuna ulaşana kadar onu poll ediyor. Krediler job başladığında tutuluyor ve tamamlandığında mutabık kılınıyor. Özel bir hesap endpoint'i, abonelik, satın alınan ve rezerve tutarlar arasındaki kredi dağılımını rate-limit durumuyla birlikte raporluyor; yazıdaki örnek yanıt, her reset penceresi başına 60 istek limiti gösteriyor. Yaşam kontrolü için kimlik doğrulaması gerektirmeyen bir health endpoint'i mevcut.

İki katalog, eşit olmayan hazır olma durumu

API yetenekleri iki kataloga bölünüyor. Tool job'ları çağıranın sağladığı bir görüntüyü düzenler; bu genellikle bir görüntü URL'si artı seçeneklerdir. Model job'ları ise bir prompt'tan, çözünürlük ve en-boy oranı gibi parametrelerle görüntü üretir. Herkese açık tanımlayıcılar stabil Picverse isimleridir ve yazıya göre upstream sağlayıcı slug'ları hiçbir zaman açığa çıkarılmıyor; böylece bir model, müşteri entegrasyonlarını bozmadan değiştirilebiliyor.

Araçlar kataloğu 17 girdi listeliyor: iyileştirme, upscaling, keskinleştirme, restorasyon, renklendirme, fotoğraftan animeye dönüşüm, cartoon ve sketch dönüşümleri, arka plan, nesne ve watermark kaldırma, ayrıca saç modeli ve kıyafet değiştiriciler. Ancak bugün yalnızca üçü çalıştırılabilir: arka plan kaldırıcı, görüntü iyileştirici ve görüntü upscaler. Yazıya göre diğer araç tanımlayıcıları, aracın listelendiğini ama henüz çalıştırılamadığını söyleyen açık bir hata döndürüyor; bu, dahili bir allow-list'in genişletilmesine bağlı.

Modeller kataloğu daha geniş; çözünürlüğe göre kredi bantları, desteklenen oranlar, referans görüntü kuralları ve varyasyon limitleriyle birlikte 26 üretim modeli listeliyor. İsimlendirilmiş tanımlayıcılar arasında Nano Banana 2, GPT Image 2, Seedream, Qwen Image, Flux ve Imagen ailelerinden girdiler, Ideogram 3, Recraft V3, iki Stable Diffusion 3.5 varyantı ve xAI'nin Grok Imagine'ı var. Maliyetler değişiyor: yazı iyileştirme ve arka plan kaldırma için 2 kredi, pro iyileştirici için 6 kredi ve ölçeğe bağlı olarak upscaling için 2, 3 veya 6 kredi örnek veriyor ve fiyatları sabit kodlamak yerine canlı katalogdan okumayı öneriyor.

Neden önemli

Bu sürüm, Picverse'ü tüketiciye yönelik bir stüdyodan diğer servisler için potansiyel bir yapı taşına dönüştürüyor; sağlayıcı başına entegrasyonlar olmadan birçok görüntü modeli ve düzenleme işlemi üzerinde tek bir HTTP yüzeyi sunuyor. Tasarım tercihleri — CORS yok, asenkron job'lar, idempotency key'ler, stabil tanımlayıcılar ve web sitesiyle paylaşılan kredi havuzu — ürünün doğrudan sunucu taraflı ürün entegrasyonuna, tarayıcı uygulamalarına değil, yöneldiğine işaret ediyor.

Ancak uyarılar da gerçek. 17 öğelik araç kataloğu ile fiilen çalışan üç araç arasındaki uçurum, API'nin düzenleme yarısının erken aşamada olduğu anlamına geliyor ve her entegrasyon ücretli bir plan veya kredi paketi gerektiriyor. Değerlendiren geliştiriciler canlı katalogları yoklamalı, job başına kredilere bütçe ayırmalı ve mevcut allow-list'i bugün gerçekten çalışan şeyin gerçek sınırı olarak görmelidir.