Cast
Βίντεο και podcast φτιαγμένα από τα δικά σας αρχεία, επαφές και συνομιλίες.
Το Cast δεν έχει σήμερα δημόσιες μεθόδους API. Κάθε μέθοδός του φέρει τη σημαία private, οπότε κανένα κλειδί API δεν μπορεί να καλέσει καμία, ούτε ένα κλειδί με πλήρη πρόσβαση. Οι μέθοδοι παρακάτω είναι αυτές που καλούν οι οθόνες του Cast, από μια συνδεδεμένη συνεδρία του πίνακα ελέγχου. Παρατίθενται για να ξέρετε τι κάνουν οι οθόνες, όχι ως κάτι που μπορείτε να καλέσετε από τον δικό σας κώδικα.
Ένα βίντεο ή ένα podcast φτιάχνεται στον πίνακα ελέγχου: από τη σελίδα του ίδιου του Cast ή σέρνοντας το Cast πάνω σε μια επαφή, μια ομάδα επαφών, μια συνομιλία AI ή μια βάση γνώσης για ένα γρήγορο βίντεο. Απ' έξω, προσβάσιμο είναι μόνο το έτοιμο αρχείο:
- Ένα έτοιμο αρχείο είναι ένα συνηθισμένο αρχείο στο Drive σας, στον φάκελο που ορίζεται στις ρυθμίσεις του Cast, οπότε ό,τι προσφέρει το Drive για αρχεία ισχύει και γι' αυτό.
Κάθε μέθοδος ενεργεί για τον κάτοχο του χώρου εργασίας και απαντά code 1 όταν πετύχει. Μια άρνηση απαντά με αρνητικό code και λέει γιατί στο data. Κάθε μέθοδος δέχεται προαιρετικό workspace_id, για να ενεργήσει σε έναν χώρο εργασίας που διαθέτετε εκτός από τον κύριο, και κάθε μέθοδος απαιτεί συνεδρία με επίπεδο εξουσιοδότησης χρήστη (user clearance).
Τα κομμάτια
Ένα βίντεο ή ένα podcast είναι ένα κομμάτι: ένα έγγραφο με αναγνωριστικό που γράφεται cst_ ακολουθούμενο από 16 δεκαεξαδικούς χαρακτήρες. Οι σκηνές του γράφονται sc_ ακολουθούμενο από 8 δεκαεξαδικούς χαρακτήρες.
- Η
get_castsαπαριθμεί τα βίντεο και τα podcast του χώρου εργασίας, με τα νεότερα πρώτα. Μαζί με τη λίστα απαντά το πλάνο και τα όριά του, τα builds αυτού του μήνα, τις αποθηκευμένες προεπιλογές, αν αυτός ο διακομιστής μπορεί να κάνει build και μια τυπική τιμή σε πιστώσεις για κάθε βήμα. - Η
get_castδιαβάζει ένα κομμάτι με την περιγραφή (brief), τα στοιχεία, το storyboard και την κατάστασή του. Με τοframesορισμένο σεtrue, κάθε σκηνή φέρει επίσης την εικόνα του πρώτου καρέ της ως data URL. - Η
get_cast_frameδιαβάζει την εικόνα μιας σκηνής (cast_id,scene_id) ως data URL. - Η
save_castδημιουργεί ένα κομμάτι ή αλλάζει ένα. Δέχεταιcast_id(κενό δημιουργεί νέο),title(μία γραμμή, έως 120 χαρακτήρες),brief(είδος, σκοπός, περιγραφή, γλώσσα, φωνή, κύριος χαρακτήρας, διάρκεια, μέγεθος, εμφάνιση και επιλογές· τα κλειδιά που δεν γνωρίζει απορρίπτονται. Τοvoice_language, ένας κωδικός γλώσσας του πίνακα ελέγχου, είναι η γλώσσα στην οποία ονομάζονται οι φωνές όσο τοlanguageείναιauto: οι παρουσιαστές ενός podcast αποκαλούν ο ένας τον άλλον με αυτά τα ονόματα. Ο πίνακας ελέγχου το ορίζει στη δική του γλώσσα όταν φτιάχνει ένα κομμάτι),sources(έως 20 στοιχεία) καιcopy_of, που ξεκινά ένα νέο πρόχειρο από την περιγραφή, τα στοιχεία και το storyboard ενός άλλου κομματιού. Απορρίπτεται όσο ένα σενάριο ή ένα build δουλεύει πάνω στο κομμάτι. - Η
delete_castδιαγράφει ένα κομμάτι και τα καρέ του. Το αρχείο που φτιάχτηκε από αυτό παραμένει στο Drive σας.
Ένας χώρος εργασίας κρατά έως 200 κομμάτια. Τα στοιχεία ενός κομματιού είναι αρχεία και φάκελοι του Drive, επαφές, ομάδες επαφών, συνομιλίες AI, βάσεις γνώσης, πιλότοι, σύνδεσμοι και σημειώσεις. Ένας connector διατηρείται αλλά δεν μπορεί ακόμα να διαβαστεί.
Το σενάριο και το storyboard
- Η
read_cast_referenceπαρακολουθεί ένα βίντεο YouTube μόνο για το στιλ του και απαντά τι κρατά μια περιγραφή από αυτό ωςreference: την εμφάνισή του (χρώματα, γραμματοσειρά, γωνίες, κάμερα, μεταβάσεις και πόση ώρα διαρκούν, σχήμα υποτίτλων), τον ρυθμό του (δευτερόλεπτα ανά πλάνο, κοψίματα ανά λεπτό), τον ρυθμό ομιλίας, σύντομες σημειώσεις για το πώς είναι φτιαγμένο και τι προτείνει για την περιγραφή (είδος, σκοπός, τύπος, σχήμα, διάρκεια). Δέχεταιurl. Εκτελείται ως εργασία (βήματα: παρακολούθηση του βίντεο, ανάγνωση του στιλ του) και χρησιμοποιεί πιστώσεις AI. Ένα κομμάτι το ακολουθεί όταν η περιγραφή του περιέχει τοreferenceκαι τοstyleείναιreference: το σενάριο γράφεται στον ρυθμό του και το build κόβει με τις μεταβάσεις του. Τίποτα από το περιεχόμενο του βίντεο δεν διατηρείται. - Η
write_cast_scriptγράφει το σενάριο από την περιγραφή και τα στοιχεία: σκηνές με το πρώτο καρέ της καθεμιάς για ένα βίντεο, τουρ ομιλίας (turns) για ένα podcast. Δέχεταιcast_idκαι προαιρετικήinstructionέως 600 χαρακτήρων. Εκτελείται ως εργασία (βήματα: ανάγνωση των στοιχείων σας, συγγραφή του σεναρίου, σχεδίαση των πρώτων καρέ) και τα σενάρια και οι εικόνες χρησιμοποιούν πιστώσεις AI. - Η
edit_cast_storyboardεφαρμόζει έως 60 αλλαγές με τη σειρά:confirm,unconfirm,confirm_all,delete,delete_all,moveκαιset(τα λόγια μιας σκηνής, ο υπότιτλός της στην οθόνη, ο τίτλος, το νούμερο, οι κουκκίδες, το απόσπασμα και η διάταξη μιας κάρτας, και ποιος παρουσιαστής λέει ένα turn). Μια αλλαγή που δεν είναι σωστά διατυπωμένη απορρίπτει ολόκληρη την κλήση. Απαντά τα καρέ που σχεδίασε ξανά. - Η
redo_cast_sceneξαναφτιάχνει μία σκηνή. Τοmodeτης είναιrewrite,picture(νέα εικόνα, τα λόγια διατηρούνται),insert(νέα σκηνή στη θέσηposition, μετρώντας από το 0) ήkind(αλλαγή αυτού που δείχνει η σκηνή:title,card,picture,stock,screenshot,presenterήpodcast). Ηinstructionείναι έως 600 χαρακτήρες. Εκτελείται ως εργασία και οι εικόνες και η συγγραφή χρησιμοποιούν πιστώσεις AI.
Build και δημοσίευση
- Η
build_castφτιάχνει το αρχείο από το επιβεβαιωμένο storyboard και το αποθηκεύει στο Drive. Μια σκηνή που δεν είναι επιβεβαιωμένη την απορρίπτει, εκτός αν τοconfirm_allείναιtrue. Εκτελείται ως εργασία (βήματα: ηχογράφηση της φωνής, προετοιμασία των εικόνων, συναρμολόγηση των σκηνών, μίξη του ήχου, αποθήκευση στο Drive σας). Οι φωνές και οι εικόνες χρησιμοποιούν πιστώσεις AI και ένα build που πετυχαίνει προσμετράται στον μήνα. - Η
stop_cast_buildσταματά το build που δουλεύει πάνω σε ένα κομμάτι. - Η
publish_castμοιράζει ένα έτοιμο κομμάτι. Τοwayείναιlink, που ενεργοποιεί τον σύνδεσμο (ή τον απενεργοποιεί, με τοoffορισμένο σεtrue), ήemail, που στέλνει τον σύνδεσμο σε έως 10 διευθύνσεις στοto, με προαιρετικόmessageέως 1000 χαρακτήρων. Οποιοσδήποτε έχει τον σύνδεσμο μπορεί να δει ή να ακούσει μέχρι να διαγραφεί το αρχείο. - Η
quick_castφτιάχνει ένα γρήγορο βίντεο infographic για μια επαφή, μια ομάδα επαφών, μια συνομιλία AI ή μια βάση γνώσης:target_kind(contact,contact_group,chatήknowledge_base),target_id, ένα προαιρετικόtarget_nameγια τον τίτλο και μια προαιρετικήlanguageπου χρησιμοποιείται όταν οι ρυθμίσεις λένε Auto. Χρησιμοποιεί τις προεπιλογές που είναι αποθηκευμένες στις ρυθμίσεις. Εκτελείται ως εργασία (βήματα: ανάγνωση του στοιχείου, συγγραφή του σεναρίου, σχεδίαση των καρέ, build του βίντεο).
Ένας διακομιστής κάνει build ένα κομμάτι τη φορά για όλους. Ένας χώρος εργασίας κρατά το πολύ δύο θέσεις σε αυτή την ουρά, μία που κάνει build και μία που περιμένει, και μια τρίτη απορρίπτεται.
Ρυθμίσεις και πλάνα
- Η
save_cast_settingsαποθηκεύει τις προεπιλογές για τα νέα κομμάτια και για τα γρήγορα βίντεο:language(autoή κωδικός γλώσσας του πίνακα ελέγχου),voiceκαιgender,voice2καιgender2για τον δεύτερο παρουσιαστή,character,seconds,size(9:16,1:1,4:5ή16:9),style,captions,music,quick_buildκαιfolder. Αλλάζουν μόνο τα κλειδιά που στέλνετε. - Η
get_cast_plansδιαβάζει τα πλάνα με τις τιμές, τα χαρακτηριστικά και τα δικαιώματά τους, το πλάνο στο οποίο βρίσκεται ο λογαριασμός, αν το Cast είναι ενεργοποιημένο και τα builds που χρησιμοποιήθηκαν αυτόν τον μήνα. - Η
cast_set_planενεργοποιεί το Cast, αλλάζει το πλάνο (τοplan_idείναιcast_free,cast_starter,cast_growthήcast_business) ή το απενεργοποιεί (κενόplan_idήdeactivateορισμένο σεtrue). Η απενεργοποίηση διατηρεί κάθε βίντεο και podcast. Και οι δύο μέθοδοι πλάνου δέχονται προαιρετικόbilling_workspace_id, που μετρά μόνο όταν τα πλάνα του Cast κρατιούνται ανά χώρο εργασίας.
Τι απορρίπτεται
Ο πίνακας ελέγχου λέει καθένα από αυτά με λόγια δίπλα στο στοιχείο ελέγχου. Στην απάντηση της μεθόδου είναι ένα αρνητικό code με μια πρόταση στο data:
- Μόνο ο κάτοχος ενός χώρου εργασίας μπορεί να φτιάχνει βίντεο και podcast σε αυτόν. Μια δημόσια συνομιλία Assistant δεν μπορεί.
- Το Cast είναι απενεργοποιημένο για τον λογαριασμό ή έχει εξαντληθεί ο αριθμός builds του πλάνου για τον μήνα (ένα build απορρίπτεται, ένα σενάριο όχι).
- Η διάρκεια ή ο αριθμός των σκηνών ξεπερνά όσα επιτρέπει το πλάνο.
- Το κομμάτι επεξεργάζεται. Ένα σενάριο ή ένα build δουλεύει πάνω του, οπότε δεν μπορεί να αποθηκευτεί ή να επεξεργαστεί μέχρι να τελειώσει ή να σταματήσει.
- Δεν υπάρχουν αρκετές πιστώσεις AI για να πληρωθεί ένα σενάριο, μια εικόνα ή μια φωνή.