Το πιο εύκολο λάθος είναι να αντιμετωπίσετε το Rivya API και το Rivya Studio ως ανταγωνιστικές διαδρομές.
Είναι καλύτερο να τα καταλάβετε ως δύο στάδια του ίδιου προϊόντος. Το Studio είναι το σημείο όπου οι άνθρωποι εξερευνούν, επιλέγουν, ελέγχουν και συνεχίζουν τη δουλειά οπτικά. Το API είναι το σημείο όπου μια σταθερή ροή εργασίας γίνεται μέρος ενός άλλου προϊόντος, σεναρίου αυτοματισμού ή διαδικασίας συστήματος.
Αυτή η σύγκριση περιγράφει το υλοποιημένο συμβόλαιο API. Η πλευρά του API ισχύει μόνο όταν η πρόσβαση στο Public API και κάθε αναφερόμενη δυνατότητα, όπως τα webhooks, είναι ενεργές για την εγκατάσταση και διαθέσιμες στον λογαριασμό.
Αν ακόμη μαθαίνετε την επιφάνεια του API, ξεκινήστε με το Τι είναι το Rivya API;. Αυτή η σελίδα είναι πιο στενή: πώς να αποφασίσετε αν μια συγκεκριμένη εργασία ανήκει στο Studio ή στο API.
Η απόφαση σε έναν πίνακα
| Ερώτηση | Χρησιμοποιήστε Studio όταν... | Χρησιμοποιήστε το API όταν... |
|---|---|---|
| Η έξοδος είναι ακόμη διερευνητική; | ναι | όχι, η ροή εργασίας είναι ήδη επαναλήψιμη |
| Χρειάζεται άνθρωπος να συγκρίνει αποτελέσματα; | ναι | μόνο αφού η εφαρμογή σας λάβει αποτελέσματα |
| Η επιλογή μοντέλου είναι σταθερή; | όχι ακόμη | ναι, ή επιλεγμένη από τη λίστα μοντέλων API |
| Η εργασία χρειάζεται πολυμέσα αναφοράς; | κάποιος ακόμη τα προετοιμάζει | η εφαρμογή σας μπορεί να τα ανεβάσει μέσω του API αρχείων |
| Το αποτέλεσμα πρέπει να ενημερώσει άλλο σύστημα; | όχι ακόμη | ναι, μέσω περιοδικού ελέγχου ή ενεργών webhooks |
| Η χρήση credits πρέπει να μένει ορατή; | ναι, κατά τη δοκιμή | ναι, αλλά μέσω ελέγχων API σε επίπεδο λογαριασμού |
Δεν πρόκειται για το ποια επιφάνεια είναι πιο προχωρημένη. Πρόκειται για το αν η εργασία είναι έτοιμη να αυτοματοποιηθεί.
Χρησιμοποιήστε Studio όσο η δουλειά αλλάζει ακόμη
Το Studio είναι το σωστό μέρος όταν η ανθρώπινη απόφαση παραμένει η κύρια δουλειά.
Αυτό περιλαμβάνει:
επιλογή ανάμεσα σε μοντέλα εικόνας, βίντεο, ήχου ή chat
δοκιμή αν αξίζει να διατηρηθεί μια κατεύθυνση της οδηγίας
σύγκριση οπτικών αποτελεσμάτων δίπλα δίπλα
απόφαση για το αν τα reference media βοηθούν ή βλάπτουν
χρήση αποθηκευμένου ιστορικού για συνέχεια από προηγούμενο αποτέλεσμα
Αυτό ισχύει ιδιαίτερα στη δημιουργική δουλειά. Αν η δημιουργική σύνοψη δεν είναι σταθερή, η αυτοματοποίηση του αιτήματος συνήθως επιταχύνει τη σύγχυση αντί να τη μειώνει.
Χρησιμοποιήστε το API όταν η ροή εργασίας είναι επαναλήψιμη
Το API γίνεται η καλύτερη διαδρομή όταν οι είσοδοι και τα επόμενα βήματα είναι αρκετά προβλέψιμα.
Καλά σημάδια:
το προϊόν σας ξέρει ήδη ποιο μοντέλο ή ποια κατηγορία μοντέλου χρειάζεται
η είσοδος χρήστη μπορεί να χαρτογραφηθεί σε σταθερό σώμα αιτήματος
μια εργασία παρασκηνίου μπορεί να ελέγχει περιοδικά την κατάσταση χωρίς να χρειάζεται κάποιος να κοιτάζει την οθόνη
ένα ενεργό webhook μπορεί να ενημερώσει τη σωστή εγγραφή όταν τελειώσει μια εργασία
η εφαρμογή μπορεί να εξηγήσει τη χρήση credits στην ομάδα ή στον ιδιοκτήτη λογαριασμού
Σε εκείνο το σημείο, η χρήση Studio για κάθε εκτέλεση μπορεί να γίνει η πιο αργή διαδρομή. Το API επιτρέπει στο προϊόν σας να ξεκινά την εργασία απευθείας.
Ένα πρακτικό όριο: ανακάλυψη έναντι ενσωμάτωσης
Χρησιμοποιήστε Studio για ανακάλυψη.
Χρησιμοποιήστε το API για ενσωμάτωση.
Ανακάλυψη σημαίνει:
"Ποιο μοντέλο πρέπει να χρησιμοποιήσουμε;"
«Ποια δομή οδηγίας λειτουργεί;»
"Βελτιώνουν τα reference media αυτή την εργασία;"
"Είναι η ποιότητα εξόδου αρκετά καλή για αυτή τη χρήση;"
Ενσωμάτωση σημαίνει:
"Αυτή η ενέργεια χρήστη πρέπει να δημιουργήσει μία εργασία δημιουργίας."
"Αυτή η εργασία πρέπει να επαναδοκιμαστεί idempotently."
"Αυτό το αρχείο πρέπει να ανεβεί και να συνδεθεί με αίτημα μοντέλου."
"Αυτή η ολοκληρωμένη εργασία πρέπει να ενημερώσει την εγγραφή του προϊόντος μας."
Αυτό το όριο εμποδίζει το API να γίνει κρυφή επιφάνεια πειραματισμού.
Πώς πρέπει να επηρεάζουν τα credits την απόφαση
Τόσο η χρήση Studio όσο και η χρήση API αντλούν από τα ίδια credits λογαριασμού Rivya.
Αυτό σημαίνει ότι η συμπεριφορά credits πρέπει να είναι μέρος του σχεδιασμού προϊόντος, όχι σκέψη εκ των υστέρων.
Χρησιμοποιήστε πρώτα Studio όταν η ομάδα χρειάζεται ακόμη να μάθει το σχήμα κόστους. Χρησιμοποιήστε το API όταν η εργασία είναι αρκετά σταθερή ώστε το προϊόν να μπορεί να εξηγήσει πότε τα credits μπορεί να δεσμευτούν ή να καταναλωθούν.
Για τους τρέχοντες δημόσιους κανόνες, διαβάστε τα Credits του API. Αν μια ροή εργασίας είναι πολύ ακριβή για να εξηγηθεί στον ιδιοκτήτη λογαριασμού, δεν είναι ακόμη έτοιμη για αυτοματοποίηση μέσω API.
Πού τα αρχεία αλλάζουν την επιλογή
Τα reference media είναι συχνά το σημείο όπου μια ενσωμάτωση γίνεται πιο σοβαρή.
Στο Studio, ένας άνθρωπος μπορεί να ανεβάσει, να επιθεωρήσει, να ξαναδοκιμάσει και να αποφασίσει αν το αρχείο είναι αρκετά καλό. Στο API, το προϊόν σας πρέπει να χειριστεί σκόπιμα τη διαδρομή του αρχείου μέσω του API αρχείων.
Χρησιμοποιήστε Studio όταν:
η εικόνα, το βίντεο ή ο ήχος αναφοράς χρειάζεται ακόμη ανθρώπινο καθαρισμό
η ομάδα δεν είναι σίγουρη ποια αναφορά πρέπει να καθοδηγήσει το μοντέλο
οι κανόνες αρχείων δεν είναι ακόμη καθαροί για τον χρήστη
Χρησιμοποιήστε το API όταν:
η εφαρμογή μπορεί να συλλέξει το αρχείο με ασφάλεια
οι απαιτήσεις αναφοράς του μοντέλου είναι γνωστές
το αρχείο μπορεί να ανεβεί πριν από το αίτημα δημιουργίας ή chat
τα σφάλματα μπορούν να εμφανιστούν στο δικό σας προϊόν χωρίς να κρύβεται τι συνέβη
Το API αρχείων είναι χρήσιμη γέφυρα, αλλά δεν αναιρεί την ανάγκη να σχεδιάσετε την εμπειρία διαχείρισης αρχείων.
Πού το Chat αλλάζει την επιλογή
Το Chat μπορεί να ανήκει και στις δύο πλευρές.
Χρησιμοποιήστε απευθείας το Rivya Chat όταν ένας άνθρωπος εξερευνά, γράφει, ελέγχει ή αποφασίζει.
Χρησιμοποιήστε το API συνομιλίας όταν ο γύρος συνομιλίας πρέπει να εκτελείται μέσα στο δικό σας προϊόν ή στη ροή εργασίας του διακομιστή. Αυτό μπορεί να περιλαμβάνει πλήρεις αποκρίσεις, προαιρετική τμηματική μετάδοση SSE, συνεδρίες που δημιουργούνται μέσω API και υποστηριζόμενα συνημμένα αρχεία.
Το βασικό ερώτημα είναι πού πρέπει να ζει η συζήτηση. Αν η συζήτηση είναι μέρος της δουλειάς στο Rivya, χρησιμοποιήστε Rivya. Αν η συζήτηση είναι μέρος της εμπειρίας του προϊόντος σας, χρησιμοποιήστε το API.
Πότε τα webhooks είναι σήμα
Αν η ροή εργασίας σας χρειάζεται API για webhooks, πιθανότατα έχει ξεπεράσει το χειροκίνητο στάδιο του Studio. Επιβεβαιώστε ότι τα webhooks είναι ενεργά για την εγκατάσταση πριν τα θεωρήσετε μέρος του σχεδίου παραγωγής.
Τα webhooks είναι χρήσιμα όταν ένα άλλο σύστημα πρέπει να ανταποκριθεί σε ολοκληρωμένες εργασίες δημιουργίας:
να επισημάνει ένα στοιχείο υλικού ως έτοιμο
να ειδοποιήσει έναν χρήστη
να προχωρήσει ένα βήμα ελέγχου
να μεταφέρει μια αποτυχημένη εργασία στην υποστήριξη ή σε λογική επανάληψης
Αυτό είναι δουλειά ενσωμάτωσης. Το Studio μπορεί ακόμη να είναι χρήσιμο για τη δοκιμή της διαδρομής μοντέλου, αλλά ο παραγωγικός βρόχος ανήκει στο API.
Ένα ασφαλές μοτίβο μετεγκατάστασης
Μη μεταφέρετε ολόκληρη ροή εργασίας στο API μονομιάς.
Χρησιμοποιήστε αυτή τη σειρά:
δοκιμάστε την εργασία χειροκίνητα στο Studio
καταγράψτε το σταθερό μοντέλο, τη δομή της οδηγίας, τα αρχεία εισόδου και το αναμενόμενο αποτέλεσμα
διαβάστε Μοντέλα API και την αναφορά μοντέλου
υποβάλετε μία δημιουργία μέσω Γρήγορη εκκίνηση του Rivya API
προσθέστε το API αρχείων μόνο αν το μοντέλο απαιτεί πολυμέσα αναφοράς
προσθέστε webhooks μόνο αφού λειτουργεί ο περιοδικός έλεγχος και έχει ενεργοποιηθεί η σχετική πρόσβαση
προσθέστε Chat API μόνο αν το προϊόν χρειάζεται γύρους chat έξω από το Studio
Κάθε βήμα πρέπει να κάνει τη ροή εργασίας πιο εύκολη στη λειτουργία, όχι απλώς πιο αυτοματοποιημένη.
Πότε να μείνετε στο Studio
Μείνετε στο Studio όταν η εργασία χρειάζεται ακόμη:
υποκειμενικό έλεγχο
διαμόρφωση της οδηγίας
οπτική σύγκριση
εξερεύνηση μοντέλων
αποθηκευμένο δημιουργικό ιστορικό
έναν άνθρωπο να αποφασίσει αν το επόμενο βήμα είναι εικόνα, βίντεο, ήχος ή chat
Αυτό δεν είναι αδυναμία. Το Studio έχει σχεδιαστεί για αυτό το στάδιο.
Πότε να μετακινηθείτε στο API
Μετακινηθείτε στο API όταν:
η ίδια εργασία επαναλαμβάνεται συχνά
η είσοδος μπορεί να δομηθεί
το μοντέλο είναι γνωστό
η εφαρμογή πρέπει να δημιουργεί εργασίες από το δικό της UI
η κατάσταση, τα σφάλματα και τα credits μπορούν να αντιμετωπιστούν καθαρά
ο περιοδικός έλεγχος, ή τα webhooks όταν είναι ενεργά, ταιριάζουν στο παρασκήνιο του προϊόντος
Το API είναι πιο δυνατό όταν μετατρέπει μια ήδη κατανοητή ροή εργασίας Rivya σε αξιόπιστη ενέργεια προϊόντος.
Επόμενο βήμα στο Rivya
Χρησιμοποιήστε τη σελίδα Για προγραμματιστές για να δείτε μια προεπισκόπηση της επιφάνειας API.
Διαβάστε Γρήγορη εκκίνηση του Rivya API πριν γράψετε production code.
Διαβάστε Πιστοποίηση API πριν αποθηκεύσετε API key.
Διαβάστε Πώς να χτίσετε μια πολυτροπική AI ροή εργασίας με το Rivya API αν η επόμενη ερώτηση είναι πώς να συνδέσετε μοντέλα, αρχεία, chat και webhooks.
Χρησιμοποιήστε Μετακίνηση δουλειάς ανάμεσα σε Rivya Chat, Image, Video, Audio αν το έργο ανήκει ακόμη σε ανθρώπινη δουλειά Studio.
