Rivya Günlüğü
Yazar
Kategoriler
Keşfetmeye devam edin
Rivya ekibinden ilgili rehberler, ürün notları ve iş akışı çözümlemeleriyle devam edin.
Rivya API, Public API erişimi dağıtım için etkin ve hesabınız için kullanılabilir olduğunda desteklenen Rivya model yeteneklerini ürününüzde, betiğinizde veya iş akışınızda kullanmaya yönelik geliştirici sözleşmesidir.
Rivya Studio'dan ayrı bir ürün değildir. Aynı hesap sınırını, aynı kredi cüzdanını ve Rivya genelinde kullanıcıların gördüğü aynı açık model katmanını kullanır. Fark, işin nereden başladığıdır: Studio'da tıklamak yerine uygulamanız API Key ile istek gönderir.
Uç nokta ayrıntılarına ihtiyacınız varsa önce Rivya API Genel Bakış ve Rivya API Hızlı Başlangıç sayfalarına bakın. Bu makale ürün seviyesindeki açıklamadır: API ne işe yarar, nerede durur ve ne zaman ilk seçenek olmamalıdır.
Rivya API v1, uygun oturum açmış hesabın API anahtarları oluşturmasına ve API'ye hazır modelleri web arayüzü dışından çağırmasına izin verir. Geliştirici sayfaları uygulanmış sözleşmeyi açıklar; canlı dağıtım, hesap izinleri ve model hazırlığı isteğin çalışıp çalışamayacağını belirler.
Uygulanmış API yüzeyi şunları içerir:
API model listesi üzerinden model keşfi
eşzamansız görsel, video ve ses üretim görevleri
referans medya isteyen modeller için Dosyalar API yüklemeleri
açık görev ID'leriyle üretim durumu sorgulama
hesap kredisi kontrolleri
isteğe bağlı SSE akışı dahil Chat API turları
webhook'lar dağıtım için etkinse üretim tamamlanması için imzalı webhook'lar
istemci sarmalayıcısı isteyen ekipler için TypeScript SDK beta sürümü
Herkese açık geliştirici merkezi Developers sayfasıdır. Yönlendirmeli bir genel bakış, API Key ayarlarına bağlantılar ve güvenli bir hata ayıklama akışı istiyorsanız en iyi giriş noktasıdır.
Bir kişi hâlâ model seçiyor, istem şekillendiriyor, çıktı inceliyor ve bir sonraki adımı belirliyorsa Studio kullanışlıdır.
Bu karar tekrarlanabilir bir ürün akışına veya operasyonel iş akışına dönüştüğünde API kullanışlıdır.
API erişimi etkin olduğunda yaygın örnekler şunlardır:
bir ürün, kullanıcı bir özet gönderdiğinde görsel varyasyonlar üretmek istiyor
bir pazarlama iş akışı, yapılandırılmış kampanya girdilerinden görsel taslaklar oluşturmak istiyor
bir dahili araç, tarayıcıyı açtırmadan video veya ses işleri göndermek istiyor
bir destek veya içerik sistemi, kendi arayüzü içinde bir Chat modeli turu istiyor
bir arka uç hizmeti, üretim görevleri bittiğinde imzalı geri çağırma almak istiyor
Bu durumlarda Rivya API, faturalama, model seçimi ve görev durumu için ayrı bir yığın kurmaya zorlamak yerine işi aynı Rivya hesabına bağlı tutar.
API, Rivya'yı doğrudan kullanmak için tüm nedenlerin yerini almaz.
Bir insanın hâlâ modelleri keşfetmesi, istemleri şekillendirmesi, çıktıları incelemesi ve ne yapacağına karar vermesi gereken durumlarda Rivya Studio Rehberi veya kamuya açık çalışma yüzeylerini kullanın:
istem hâlâ insan keşfi gerektiriyorsa
model seçimi henüz kararlı değilse
bir üretici çıktıları görsel olarak karşılaştırması gerekiyorsa
proje kaydedilmiş geçmiş ve manuel incelemeye bağlıysa
ekip hangi giriş ve çıkış biçiminin tekrar edilebilir olması gerektiğine henüz karar vermediyse
İş akışı otomatikleştirilebilecek kadar açıksa API kullanın.
Bu sınır önemlidir. Belirsiz bir yaratıcı soru önce Studio'ya aittir. Girdileri öngörülebilir olan bilinen bir ürün akışı ise API'ye taşınabilir.
API'yi altı bağlı parça olarak düşünebilirsiniz.
| Bileşen | Ne yapar | Sonra ne okunur |
|---|---|---|
| API anahtarları | Hesabınızdan sunucu-sunucu erişim sağlar | API Kimlik Doğrulaması |
| Models | Açık model ID'lerini ve hazır olma bilgisini verir | API Modelleri |
| Generations | Eşzamansız görsel, video ve ses işleri gönderir | Oluşturma İşi Başlatma |
| Dosyalar | Referans görsel, video veya ses yüklemelerini yönetir | Dosyalar API |
| Chat | Akışsız veya akışlı Chat turları gönderir | Chat API |
| Webhooks | Etkin olduğunda üretim görevleri için imzalı tamamlanma olayları | API Webhooks |
İstek ve yanıt yapısı için kaynak API dokümanlarıdır. Bu makale yalnızca önce hangi parçaya ihtiyacınız olduğunu anlamanıza yardım etmelidir.
API kullanımı, Studio ile aynı Rivya hesap kredi cüzdanından düşer.
Yani API anonim bir model aracı değildir. Her istek bir Rivya hesabına aittir, bu hesap tarafından oluşturulmuş bir API Key kullanır ve API Kredileri içinde açıklanan aynı ürün seviyesi kredi sınırlarını izler.
Bu ekipler için kullanışlıdır; çünkü Studio deneyleri ve API kullanımı tek bir operasyonel modelde kalır. Bir modeli manuel test edip sonra tekrar eden kısmı entegrasyona taşıyabilirsiniz; ikinci bir faturalama katmanı kurmanız gerekmez.
Bazı modeller yalnızca metin girdisiyle çalışır. Bazıları referans görsel, video veya ses dosyası ister.
API entegrasyonlarında bu referanslar Dosyalar API üzerinden geçmelidir. Yükleme, desteklenen model parametrelerine iletilebilecek yönetilen bir dosya kaydı oluşturur.
Pratik kural basittir:
model metin girdisini kabul ediyorsa, üretim uç noktasıyla başlayın
model referans medya istiyorsa, önce dosyayı yükleyin
model görsel ekleri olan bir Chat modeli ise, Chat API ve dosya ID'leri kullanın
Entegrasyonunuzu yalnızca tarayıcı tabanlı yükleme akışlarına veya kaydedilmiş Studio oturumlarına göre tasarlamayın. API'nin kendi açık dosya sınırı bunun için var.
Yoklama, ilk entegrasyon yolu olarak en kolay seçenektir. Bir üretim işi gönderin, açık görev ID'sini kaydedin ve başarılı ya da başarısız olana kadar sorgulayın.
Webhook'lar dağıtım için etkin olduğunda entegrasyon üretime yaklaştıkça yararlı olur:
bir worker'ın her görevi sürekli yoklamasını istemezsiniz
uygulamanız üretim bittiğinde bir kaydı güncellemek ister
güvenli şekilde yeniden denenebilen imzalı bir olay istersiniz
başarısız işler net bir kurtarma yoluna girmelidir
İmzalı olay sözleşmesi için API Webhooks kullanın. Tasarımı buna bağlamadan önce özelliğin kullanılabilir olduğunu doğrulayın. Alıcıyı dar tutun: imzaları doğrulayın, yinelenen olayları işleyin ve gizli değerleri loglara yazmayın.
İlk API projesi genelde küçük ve somut olmalıdır.
Örneğin:
API erişiminin dağıtım ve hesap için etkin olduğunu doğrulayın
ayarlarda API anahtarı oluşturun
model listesini çağırın
API'ye hazır bir model seçin
idempotency anahtarıyla üretim görevi gönderin
durum uç nokta'ini sorgulayın
kredileri önce ve sonra kontrol edin
ancak ardından dağıtımın sunduğu Dosyalar API, Chat API veya Webhooks'u ekleyin
Bu yol, ilk testte API'nin tüm özelliklerini birbirine karıştırmadan çalışan bir entegrasyon sağlar.
Aşağıdaki durumlarda API muhtemelen ilk adım değildir:
ekip henüz bir model ailesi seçmemişse
istenen çıktı her çalıştırmada değişiyorsa
istem, insan zevkine ve manuel incelemeye çok fazla bağlıysa
entegrasyon, kredilerin nasıl harcandığını anlaması gereken kişilerden tüketimi gizleyecekse
ürünün önce otomasyondan değil, herkese açık bir demoya ihtiyacı varsa
Bu durumlarda Image, Video, Audio, Chat veya AI Models ile başlayın. Yol tekrar edilebilir hale gelince kararlı kısmı API'ye taşıyın.
Kamuya açık API merkezi ve hata ayıklayıcı için Developers sayfasını açın.
İlk güvenli isteği göndermek için Rivya API Hızlı Başlangıç okuyun.
API Key'i bir sunucuya koymadan önce API Kimlik Doğrulaması okuyun.
Model ID seçmeden önce API Modelleri okuyun.
Ürün sınırı hâlâ net değilse Rivya API ile Studio Arasında Ne Zaman Seçim Yapılır? sayfasını okuyun.
Tam bir görsel, video, ses veya sohbet entegrasyonu planlıyorsanız Rivya API ile Multimodal AI İş Akışı Nasıl Kurulur sayfasını okuyun.
