En kolay hata, Rivya API ile Rivya Studio'yu rakip yollar gibi görmektir.
Onları aynı ürünün iki aşaması olarak anlamak daha doğrudur. Studio, insanların görsel olarak keşfettiği, seçtiği, incelediği ve işi devam ettirdiği yerdir. API ise kararlı bir iş akışının başka bir ürünün, betiğin veya arka uç sürecinin parçası olduğu yerdir.
Bu karşılaştırma uygulanmış API sözleşmesini açıklar. API tarafı yalnızca Public API ve webhook gibi ilgili özellikler dağıtım için etkin, hesap için kullanılabilir olduğunda geçerlidir. API yüzeyini hâlâ öğreniyorsanız Rivya API Nedir? ile başlayın. Bu sayfa daha dar kapsamlıdır: belirli bir görevin Studio'da mı yoksa API'de mi olması gerektiğine nasıl karar verilir?
Karar Tek Tabloda
| Soru | Studio kullanın, eğer... | API kullanın, eğer... |
|---|---|---|
| Çıktı hâlâ keşif aşamasında mı? | evet | hayır, iş akışı zaten tekrarlanabilir |
| Bir kişinin sonuçları karşılaştırması gerekiyor mu? | evet | yalnızca uygulamanız sonuçları aldıktan sonra |
| Model seçimi kararlı mı? | henüz değil | evet, veya API model listesinden seçiliyor |
| Görev referans medya gerektiriyor mu? | bir kişi hâlâ hazırlıyorsa | uygulamanız Dosyalar API üzerinden yükleyebiliyorsa |
| Sonuç başka sistemi güncellemeli mi? | henüz değil | evet, polling veya etkin webhook'lar aracılığıyla |
| Kredi kullanımının görünür kalması gerekiyor mu? | evet, test ederken | evet, ama hesap düzeyi API kontrolleriyle |
Bu, hangi yüzeyin daha gelişmiş olduğu hakkında değildir. Görevin otomasyona hazır olup olmadığı hakkındadır.
İş Hâlâ Değişiyorsa Studio Kullanın
İnsan kararı hâlâ ana işse Studio doğru yerdir.
Buna şunlar dahildir:
görüntü, video, ses veya sohbet modelleri arasında seçim yapmak
bir istem yönünün saklanmaya değer olup olmadığını test etmek
görsel sonuçları yan yana karşılaştırmak
referans medyanın yardımcı mı yoksa zararlı mı olduğuna karar vermek
önceki bir sonuçtan devam etmek için kayıtlı geçmişi kullanmak
Bu özellikle yaratıcı işler için geçerlidir. Özet kararlı değilse isteği otomatikleştirmek genellikle karışıklığı küçültmek yerine hızlandırır.
İş Akışı Tekrarlanabilirse API Kullanın
Girdiler ve sonraki adımlar yeterince öngörülebilir olduğunda API daha iyi yol olur.
İyi işaretler:
ürününüz ihtiyaç duyduğu modeli veya model kategorisini zaten biliyor
kullanıcı girdisi kararlı bir istek gövdesine eşlenebiliyor
bir arka uç işi, birinin ekrana bakmasına gerek kalmadan durumu yoklama ile izleyebiliyor
etkin webhook görev tamamlandığında doğru kaydı güncelleyebilir
uygulama kredi kullanımını ekibe veya hesap sahibine açıklayabiliyor
Bu noktada her çalışma için Studio kullanmak daha yavaş yol haline gelebilir. API, ürününüzün görevi doğrudan başlatmasını sağlar.
Pratik Sınır: Keşif ve Entegrasyon
Keşif için Studio kullanın.
Entegrasyon için API kullanın.
Keşif şu anlama gelir:
"Hangi modeli kullanmalıyız?"
"Hangi istem şekli çalışıyor?"
"Referans medya bu görevi iyileştiriyor mu?"
"Çıktı kalitesi bu kullanım senaryosu için yeterli mi?"
Entegrasyon şu anlama gelir:
"Bu kullanıcı aksiyonu tek bir üretim görevi oluşturmalı."
"Bu iş idempotent şekilde yeniden denenmeli."
"Bu dosya yüklenip bir model isteğine eklenmeli."
"Bu tamamlanan görev ürün kaydımızı güncellemeli."
Bu sınır API'nin gizli bir deney yüzeyine dönüşmesini engeller.
Krediler Kararı Nasıl Etkilemeli?
Hem Studio hem API kullanımı aynı Rivya hesap kredilerinden çeker.
Bu, kredi davranışının sonradan eklenen bir açıklama değil, ürün tasarımının parçası olması gerektiği anlamına gelir.
Ekip hâlâ maliyet şeklini öğreniyorsa önce Studio kullanın. Görev, ürünün kredilerin ne zaman ayrılabileceğini veya tüketilebileceğini açıklayabileceği kadar kararlı olduğunda API kullanın.
Mevcut herkese açık kurallar için API Kredileri sayfasını okuyun. Bir iş akışı hesap sahibine açıklanamayacak kadar pahalıysa henüz API otomasyonuna hazır değildir.
Dosyalar Seçimi Nerede Değiştirir?
Referans medya çoğu zaman entegrasyonun ciddileştiği yerdir.
Studio'da bir kişi dosya yükleyebilir, inceleyebilir, yeniden deneyebilir ve dosyanın yeterince iyi olup olmadığına karar verebilir. API'de ürününüz dosya yolunu Dosyalar API üzerinden bilinçli şekilde yönetmelidir.
Studio kullanın, eğer:
referans görsel, video veya ses hâlâ insan temizliği gerektiriyorsa
ekip hangi referansın modeli yönlendirmesi gerektiğinden emin değilse
dosya kuralları kullanıcıya henüz net anlatılamıyorsa
API kullanın, eğer:
uygulama dosyayı güvenle toplayabiliyorsa
modelin referans gereksinimleri biliniyorsa
dosya üretim veya Chat isteğinden önce yüklenebiliyorsa
hatalar ne olduğunu gizlemeden kendi ürününüzde gösterilebiliyorsa
Dosyalar API yararlı bir köprüdür, ama dosya deneyimini tasarlama ihtiyacını ortadan kaldırmaz.
Chat Seçimi Nerede Değiştirir?
Chat iki tarafa da ait olabilir.
Bir kişi keşfediyor, yazıyor, inceliyor veya karar veriyorsa Rivya Chat'i doğrudan kullanın.
Chat turunun kendi ürününüzde veya sunucu iş akışınızda yaşaması gerekiyorsa Chat API kullanın. Buna akışsız turlar, isteğe bağlı SSE akışı, API tarafından oluşturulan oturumlar ve desteklenen dosya ekleri dahil olabilir.
Ana soru konuşmanın nerede yaşaması gerektiğidir. Konuşma Rivya işinin parçasıysa Rivya kullanın. Konuşma ürün deneyiminizin parçasıysa API kullanın.
Webhooks Ne Zaman Sinyaldir?
Akışınız API Webhooks gerektiriyorsa muhtemelen manuel Studio aşamasını aşmıştır. Üretim tasarımının parçası saymadan önce webhook'ların dağıtım için etkin olduğunu doğrulayın.
Webhook'lar, başka bir sistemin tamamlanan üretim görevlerine yanıt vermesi gerektiğinde yararlıdır:
bir varlığı hazır olarak işaretlemek
kullanıcıyı bilgilendirmek
inceleme adımını ilerletmek
başarısız görevi destek veya yeniden deneme mantığına taşımak
Bu entegrasyon işidir. Studio model yolunu test etmek için hâlâ yararlı olabilir, ama üretim döngüsü API'ye aittir.
Güvenli Bir Geçiş Kalıbı
Tüm iş akışını bir anda API'ye taşımayın.
Şu sırayı kullanın:
görevi Studio'da manuel test edin
kararlı modeli, istem şeklini, girdi dosyalarını ve beklenen sonucu yazın
API Modelleri ve model referansını okuyun
Rivya API Hızlı Başlangıç üzerinden tek bir üretim isteği gönderin
Dosyalar API'yi yalnızca model referans medya gerektiriyorsa ekleyin
Webhooks'u yalnızca polling çalıştıktan ve webhook erişimi etkinleştirildikten sonra ekleyin
Chat API'yi yalnızca ürün Studio dışında Chat turlarına ihtiyaç duyuyorsa ekleyin
Her adım iş akışını yalnızca daha otomatik değil, işletmesi daha kolay hale getirmelidir.
Ne Zaman Studio'da Kalmalı?
Görev hâlâ şunlara ihtiyaç duyuyorsa Studio'da kalın:
öznel inceleme
istem şekillendirme
görsel karşılaştırma
model keşfi
kayıtlı yaratıcı geçmiş
sonraki adımın görüntü, video, ses veya Chat olup olmadığına karar veren bir kişi
Bu zayıflık değildir. Studio o aşama için tasarlanmıştır.
Ne Zaman API'ye Geçmeli?
Şu durumlarda API'ye geçin:
aynı görev sık tekrarlanıyorsa
girdi yapılandırılabiliyorsa
model biliniyorsa
uygulama kendi arayüzünden görev oluşturmak zorundaysa
durum, hatalar ve krediler açıkça yönetilebiliyorsa
polling veya etkin olduğunda webhook'lar ürün backend'ine uygundur
API, zaten anlaşılmış bir Rivya iş akışını güvenilir bir ürün aksiyonuna dönüştürdüğünde en güçlüdür.
Rivya'da Sonraki Adım
API yüzeyini önizlemek için Developers kullanın.
Üretim kodu yazmadan önce Rivya API Hızlı Başlangıç okuyun.
API anahtarı saklamadan önce API Kimlik Doğrulaması okuyun.
Sonraki soru modelleri, dosyaları, Chat'i ve Webhook'ları bağlamaksa Rivya API ile Multimodal AI İş Akışı Nasıl Kurulur sayfasını okuyun.
Proje hâlâ insan liderliğindeki Studio işine aitse Rivya Chat, Image, Video ve Audio Arasında İşi Taşımak sayfasını kullanın.
