Πότε να χρησιμοποιήσετε το Rivya API αντί για Studio

Το πιο εύκολο λάθος είναι να αντιμετωπίσετε το Rivya API και το Rivya Studio ως ανταγωνιστικές διαδρομές.

Είναι καλύτερο να τα καταλάβετε ως δύο στάδια του ίδιου προϊόντος. Το Studio είναι το σημείο όπου οι άνθρωποι εξερευνούν, επιλέγουν, ελέγχουν και συνεχίζουν τη δουλειά οπτικά. Το API είναι το σημείο όπου μια σταθερή ροή εργασίας γίνεται μέρος ενός άλλου προϊόντος, script ή backend διαδικασίας.

Αν ακόμη μαθαίνετε την επιφάνεια του API, ξεκινήστε με το Τι είναι το Rivya API;. Αυτή η σελίδα είναι πιο στενή: πώς να αποφασίσετε αν μια συγκεκριμένη εργασία ανήκει στο Studio ή στο API.

Η απόφαση σε έναν πίνακα

Δεν πρόκειται για το ποια επιφάνεια είναι πιο προχωρημένη. Πρόκειται για το αν η εργασία είναι έτοιμη να αυτοματοποιηθεί.

Χρησιμοποιήστε Studio όσο η δουλειά αλλάζει ακόμη

Το Studio είναι το σωστό μέρος όταν η ανθρώπινη απόφαση παραμένει η κύρια δουλειά.

Αυτό περιλαμβάνει:

• επιλογή ανάμεσα σε μοντέλα εικόνας, βίντεο, ήχου ή chat
• δοκιμή αν μια κατεύθυνση prompt αξίζει να κρατηθεί
• σύγκριση οπτικών αποτελεσμάτων δίπλα δίπλα
• απόφαση για το αν τα reference media βοηθούν ή βλάπτουν
• χρήση αποθηκευμένου ιστορικού για συνέχεια από προηγούμενο αποτέλεσμα

Αυτό ισχύει ιδιαίτερα στη δημιουργική δουλειά. Αν το brief δεν είναι σταθερό, η αυτοματοποίηση του αιτήματος συνήθως κάνει τη σύγχυση πιο γρήγορη αντί για μικρότερη.

Χρησιμοποιήστε το API όταν η ροή εργασίας είναι επαναλήψιμη

Το API γίνεται η καλύτερη διαδρομή όταν οι είσοδοι και τα επόμενα βήματα είναι αρκετά προβλέψιμα.

Καλά σημάδια:

• το προϊόν σας ξέρει ήδη ποιο μοντέλο ή ποια κατηγορία μοντέλου χρειάζεται
• η είσοδος χρήστη μπορεί να χαρτογραφηθεί σε σταθερό request body
• ένα backend job μπορεί να κάνει poll την κατάσταση χωρίς να κοιτάζει κάποιος οθόνη
• ένα webhook μπορεί να ενημερώσει τη σωστή εγγραφή όταν τελειώσει μια εργασία
• η εφαρμογή μπορεί να εξηγήσει τη χρήση credits στην ομάδα ή στον ιδιοκτήτη λογαριασμού

Σε εκείνο το σημείο, η χρήση Studio για κάθε εκτέλεση μπορεί να γίνει η πιο αργή διαδρομή. Το API επιτρέπει στο προϊόν σας να ξεκινά την εργασία απευθείας.

Ένα πρακτικό όριο: ανακάλυψη έναντι ενσωμάτωσης

Χρησιμοποιήστε Studio για ανακάλυψη.

Χρησιμοποιήστε το API για ενσωμάτωση.

Ανακάλυψη σημαίνει:

• "Ποιο μοντέλο πρέπει να χρησιμοποιήσουμε;"
• "Ποιο σχήμα prompt λειτουργεί;"
• "Βελτιώνουν τα reference media αυτή την εργασία;"
• "Είναι η ποιότητα εξόδου αρκετά καλή για αυτή τη χρήση;"

Ενσωμάτωση σημαίνει:

• "Αυτή η ενέργεια χρήστη πρέπει να δημιουργήσει μία εργασία δημιουργίας."
• "Αυτή η εργασία πρέπει να επαναδοκιμαστεί idempotently."
• "Αυτό το αρχείο πρέπει να ανεβεί και να συνδεθεί με αίτημα μοντέλου."
• "Αυτή η ολοκληρωμένη εργασία πρέπει να ενημερώσει την εγγραφή του προϊόντος μας."

Αυτό το όριο εμποδίζει το API να γίνει κρυφή επιφάνεια πειραματισμού.

Πώς πρέπει να επηρεάζουν τα credits την απόφαση

Τόσο η χρήση Studio όσο και η χρήση API αντλούν από τα ίδια credits λογαριασμού Rivya.

Αυτό σημαίνει ότι η συμπεριφορά credits πρέπει να είναι μέρος του σχεδιασμού προϊόντος, όχι σκέψη εκ των υστέρων.

Χρησιμοποιήστε πρώτα Studio όταν η ομάδα χρειάζεται ακόμη να μάθει το σχήμα κόστους. Χρησιμοποιήστε το API όταν η εργασία είναι αρκετά σταθερή ώστε το προϊόν να μπορεί να εξηγήσει πότε τα credits μπορεί να δεσμευτούν ή να καταναλωθούν.

Για τους τρέχοντες δημόσιους κανόνες, διαβάστε API Credits. Αν μια ροή εργασίας είναι πολύ ακριβή για να εξηγηθεί στον ιδιοκτήτη λογαριασμού, δεν είναι ακόμη έτοιμη για αυτοματοποίηση API.

Πού τα αρχεία αλλάζουν την επιλογή

Τα reference media είναι συχνά το σημείο όπου μια ενσωμάτωση γίνεται πιο σοβαρή.

Στο Studio, ένας άνθρωπος μπορεί να ανεβάσει, να επιθεωρήσει, να ξαναδοκιμάσει και να αποφασίσει αν το αρχείο είναι αρκετά καλό. Στο API, το προϊόν σας πρέπει να χειριστεί τη διαδρομή αρχείου σκόπιμα μέσω Files API.

Χρησιμοποιήστε Studio όταν:

• η εικόνα, το βίντεο ή ο ήχος αναφοράς χρειάζεται ακόμη ανθρώπινο καθαρισμό
• η ομάδα δεν είναι σίγουρη ποια αναφορά πρέπει να καθοδηγήσει το μοντέλο
• οι κανόνες αρχείων δεν είναι ακόμη καθαροί για τον χρήστη

Χρησιμοποιήστε το API όταν:

• η εφαρμογή μπορεί να συλλέξει το αρχείο με ασφάλεια
• οι απαιτήσεις αναφοράς του μοντέλου είναι γνωστές
• το αρχείο μπορεί να ανεβεί πριν από το αίτημα δημιουργίας ή chat
• τα σφάλματα μπορούν να εμφανιστούν στο δικό σας προϊόν χωρίς να κρύβεται τι συνέβη

Το Files API είναι χρήσιμη γέφυρα, αλλά δεν αφαιρεί την ανάγκη να σχεδιάσετε την εμπειρία αρχείων.

Πού το Chat αλλάζει την επιλογή

Το Chat μπορεί να ανήκει και στις δύο πλευρές.

Χρησιμοποιήστε απευθείας το Rivya Chat όταν ένας άνθρωπος εξερευνά, γράφει, ελέγχει ή αποφασίζει.

Χρησιμοποιήστε Chat API όταν ο γύρος chat πρέπει να ζει μέσα στο δικό σας προϊόν ή στη ροή εργασίας του server. Αυτό μπορεί να περιλαμβάνει non-streaming γύρους, προαιρετικό SSE streaming, sessions που δημιουργούνται από API και υποστηριζόμενα συνημμένα αρχεία.

Το βασικό ερώτημα είναι πού πρέπει να ζει η συζήτηση. Αν η συζήτηση είναι μέρος της δουλειάς στο Rivya, χρησιμοποιήστε Rivya. Αν η συζήτηση είναι μέρος της εμπειρίας του προϊόντος σας, χρησιμοποιήστε το API.

Πότε τα webhooks είναι σήμα

Αν η ροή εργασίας σας χρειάζεται API Webhooks, πιθανότατα έχει περάσει το χειροκίνητο στάδιο Studio.

Τα webhooks είναι χρήσιμα όταν ένα άλλο σύστημα πρέπει να ανταποκριθεί σε ολοκληρωμένες εργασίες δημιουργίας:

• να σημάνει ένα asset ως έτοιμο
• να ειδοποιήσει έναν χρήστη
• να προχωρήσει ένα βήμα ελέγχου
• να μεταφέρει μια αποτυχημένη εργασία σε υποστήριξη ή λογική retry

Αυτό είναι δουλειά ενσωμάτωσης. Το Studio μπορεί ακόμη να είναι χρήσιμο για τη δοκιμή της διαδρομής μοντέλου, αλλά ο παραγωγικός βρόχος ανήκει στο API.

Ένα ασφαλές μοτίβο μετεγκατάστασης

Μη μεταφέρετε ολόκληρη ροή εργασίας στο API μονομιάς.

Χρησιμοποιήστε αυτή τη σειρά:

1. δοκιμάστε την εργασία χειροκίνητα στο Studio
2. γράψτε το σταθερό μοντέλο, το σχήμα prompt, τα αρχεία εισόδου και το αναμενόμενο αποτέλεσμα
3. διαβάστε Μοντέλα API και την αναφορά μοντέλου
4. υποβάλετε μία δημιουργία μέσω Γρήγορη εκκίνηση του Rivya API
5. προσθέστε Files API μόνο αν το μοντέλο απαιτεί reference media
6. προσθέστε Webhooks μόνο αφού λειτουργεί το polling
7. προσθέστε Chat API μόνο αν το προϊόν χρειάζεται γύρους chat έξω από το Studio

Κάθε βήμα πρέπει να κάνει τη ροή εργασίας πιο εύκολη στη λειτουργία, όχι απλώς πιο αυτοματοποιημένη.

Πότε να μείνετε στο Studio

Μείνετε στο Studio όταν η εργασία χρειάζεται ακόμη:

• υποκειμενικό έλεγχο
• διαμόρφωση prompt
• οπτική σύγκριση
• εξερεύνηση μοντέλων
• αποθηκευμένο δημιουργικό ιστορικό
• έναν άνθρωπο να αποφασίσει αν το επόμενο βήμα είναι εικόνα, βίντεο, ήχος ή chat

Αυτό δεν είναι αδυναμία. Το Studio έχει σχεδιαστεί για αυτό το στάδιο.

Πότε να μετακινηθείτε στο API

Μετακινηθείτε στο API όταν:

• η ίδια εργασία επαναλαμβάνεται συχνά
• η είσοδος μπορεί να δομηθεί
• το μοντέλο είναι γνωστό
• η εφαρμογή πρέπει να δημιουργεί εργασίες από το δικό της UI
• η κατάσταση, τα σφάλματα και τα credits μπορούν να αντιμετωπιστούν καθαρά
• το polling ή τα webhooks ταιριάζουν στο backend του προϊόντος

Το API είναι πιο δυνατό όταν μετατρέπει μια ήδη κατανοητή ροή εργασίας Rivya σε αξιόπιστη ενέργεια προϊόντος.

Επόμενο βήμα στο Rivya

• Χρησιμοποιήστε Developers για να κάνετε προεπισκόπηση της επιφάνειας API.
• Διαβάστε Γρήγορη εκκίνηση του Rivya API πριν γράψετε production code.
• Διαβάστε Πιστοποίηση API πριν αποθηκεύσετε API key.
• Διαβάστε Πώς να χτίσετε μια πολυτροπική AI ροή εργασίας με το Rivya API αν η επόμενη ερώτηση είναι πώς να συνδέσετε μοντέλα, αρχεία, chat και webhooks.
• Χρησιμοποιήστε Μετακίνηση δουλειάς ανάμεσα σε Rivya Chat, Image, Video, Audio αν το έργο ανήκει ακόμη σε ανθρώπινη δουλειά Studio.