Rivya API, Rivya model yeteneklerini kendi ürününüz, betiğiniz veya iş akışınız içinden kullanmak için geliştirici yoludur.
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.
Kısa Versiyon
Rivya API v1, giriş yapılmış bir hesabın API Key oluşturup Rivya model yeteneklerini web arayüzünün dışından çağırmasına izin verir.
Mevcut API yüzeyi şunları içerir:
- API model listesi üzerinden model keşfi
- eşzamansız image, video ve audio üretim görevleri
- referans medya isteyen modeller için Files API yüklemeleri
- açık görev ID'leriyle üretim durumu sorgulama
- hesap kredisi kontrolleri
- isteğe bağlı SSE streaming dahil Chat API turları
- üretim tamamlandığında imzalı Webhook'lar
- client wrapper 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.
Rivya Neden API'ye Sahip
Bir kişi hâlâ model seçiyor, prompt ş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.
Yaygın örnekler:
- bir ürün, kullanıcı bir brief 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 audio 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 Neyi Yerine Koymaz
API, Rivya'yı doğrudan kullanmak için tüm nedenlerin yerini almaz.
Bir insanın hâlâ modelleri keşfetmesi, prompt'ları ş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:
- prompt 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.
Ana Bileşenler
API'yi altı bağlı parça olarak düşünebilirsiniz.
| Bileşen | Ne yapar | Sonra ne okunur |
|---|---|---|
| API keys | 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 image, video ve audio işleri gönderir | Oluşturma İşi Başlatma |
| Files | Referans image, video veya audio yüklemelerini yönetir | Files API |
| Chat | Streaming olmayan veya streaming Chat turları gönderir | Chat API |
| Webhooks | Üretim görevleri için imzalı tamamlama olayları alır | 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.
Krediler Nasıl Çalışır
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.
Files API Ne Zaman Devreye Girer
Bazı modeller yalnızca metin girdisiyle çalışır. Bazıları referans image, video veya audio dosyası ister.
API entegrasyonlarında bu referanslar Files 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 image ekleri olan bir Chat modeli ise, Chat API ve file 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.
Webhook'lar Nerede İşe Yarar
Polling, 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 daha üretim benzeri entegrasyonlarda işe yarar:
- bir worker'ın her görevi sürekli polling yapması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 sayfasını kullanın. Webhook alıcısını dar tutun: imzaları doğrulayın, yinelenen olayları yönetin ve secret değerleri loglara yazmayın.
İyi Bir İlk API Projesi
İlk API projesi genelde küçük ve somut olmalıdır.
Örneğin:
- ayarlarda bir API Key oluşturun
- model listesini çağırın
- kullanılabilir bir model seçin
- bir idempotency key ile tek bir üretim işi gönderin
- durum uç noktasını polling ile izleyin
- kredileri önce ve sonra kontrol edin
- ancak bundan sonra Files API, Chat API veya Webhook'lar ekleyin
Bu yol, ilk testte API'nin tüm özelliklerini birbirine karıştırmadan çalışan bir entegrasyon sağlar.
API Ne Zaman Yanlış Başlangıçtır
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
- prompt, 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, halka açık bir demodan ihtiyacı varsa
Bu durumlarda Image, Video, Audio, Chat veya AI Models ile başlayın. Yol tekrar edilebilir hale gelince stabil kısmı API'ye taşıyın.
Sonra Nereye Bakmalı
- 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.
- 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 image, video, audio veya chat entegrasyonu planlıyorsanız Rivya API ile Multimodal AI İş Akışı Nasıl Kurulur sayfasını okuyun.
