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.
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 Files API üzerinden yükleyebiliyorsa |
| Sonucun başka bir sistemi güncellemesi gerekiyor mu? | henüz değil | evet, yoklama veya Webhook'lar ile |
| 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 prompt 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. Brief 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
- görev bittiğinde Webhook doğru kaydı güncelleyebiliyor
- 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 prompt ş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 Files 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
Files 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 streaming olmayan 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ı geçmiştir.
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, prompt ş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
- Files API'yi yalnızca model referans medya gerektiriyorsa ekleyin
- Webhook'ları yalnızca yoklama çalıştıktan 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
- prompt ş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
- yoklama veya Webhook'lar ürünün arka ucuna uyuyorsa
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.
