Cast
Video e podcast creati dai tuoi file, contatti e chat.
Cast oggi non ha metodi API pubblici. Ogni suo metodo porta il flag private, quindi nessuna chiave API può chiamarne uno, nemmeno una chiave con accesso completo. I metodi qui sotto sono ciò che le schermate di Cast chiamano, da una sessione della dashboard con accesso effettuato. Sono elencati perché tu sappia che cosa fanno le schermate, non come qualcosa da chiamare dal tuo codice.
Un video o un podcast si crea nella dashboard: dalla pagina di Cast, oppure trascinando Cast su un contatto, un gruppo di contatti, una chat AI o una knowledge base per un video rapido. Dall'esterno è raggiungibile solo il file finito:
- Un file finito è un normale file nel tuo Drive, nella cartella impostata nelle impostazioni di Cast, quindi su di esso funziona ciò che Drive offre per i file.
Ogni metodo agisce per il proprietario del workspace e risponde code 1 quando funziona. Un rifiuto risponde con un code negativo e ne spiega il motivo in data. Ogni metodo accetta un workspace_id facoltativo, per agire in un workspace di tua proprietà diverso da quello principale, e ogni metodo richiede una sessione con livello di accesso utente.
I pezzi
Un video o un podcast è un pezzo: un documento con un id che si legge cst_ seguito da 16 caratteri esadecimali. Le sue scene si leggono sc_ seguito da 8 caratteri esadecimali.
get_castselenca i video e i podcast del workspace, dal più recente. Insieme all'elenco risponde con il piano e i suoi limiti, le build di questo mese, le impostazioni predefinite salvate, se questo server può creare e un prezzo tipico in crediti per ogni passaggio.get_castlegge un pezzo con il suo brief, gli elementi, lo storyboard e lo stato. Conframesimpostato sutrue, ogni scena porta anche l'immagine del suo primo fotogramma come data URL.get_cast_framelegge l'immagine di una scena (cast_id,scene_id) come data URL.save_castcrea un pezzo, oppure ne modifica uno. Accettacast_id(vuoto ne crea uno nuovo),title(una riga, fino a 120 caratteri),brief(tipo, scopo, descrizione, lingua, voce, personaggio principale, durata, dimensione, aspetto e opzioni; le chiavi che non conosce vengono scartate.voice_language, un codice lingua della dashboard, è la lingua in cui sono nominate le voci quandolanguageèauto: i conduttori di un podcast si chiamano a vicenda con quei nomi. La dashboard lo imposta sulla propria lingua quando crea un pezzo),sources(fino a 20 elementi) ecopy_of, che avvia una nuova bozza dal brief, dagli elementi e dallo storyboard di un altro pezzo. Viene rifiutato mentre un copione o una build è al lavoro sul pezzo.delete_castelimina un pezzo e i suoi fotogrammi. Il file creato da esso resta nel tuo Drive.
Un workspace conserva fino a 200 pezzi. Gli elementi di un pezzo sono file e cartelle di Drive, contatti, gruppi di contatti, chat AI, knowledge base, pilot, link e note. Un connettore viene conservato ma non può ancora essere letto.
Il copione e lo storyboard
read_cast_referenceguarda un video YouTube solo per il suo stile e risponde ciò che un brief ne conserva comereference: il suo aspetto (colori, caratteri, angoli, camera, transizioni e quanto durano, forma dei sottotitoli), il suo ritmo (secondi per inquadratura, tagli al minuto), la velocità del parlato, brevi note su come è fatto, e ciò che suggerisce per il brief (genere, scopo, tipo, formato, durata). Accettaurl. Viene eseguito come job (passaggi: guardare il video, leggere il suo stile) e usa crediti AI. Un pezzo lo segue quando il suo brief contiene lareferenceestyleèreference: il copione viene scritto al suo ritmo e la costruzione monta con le sue transizioni. Nulla del contenuto del video viene conservato.write_cast_scriptscrive il copione dal brief e dagli elementi: scene con il primo fotogramma di ciascuna per un video, interventi per un podcast. Accettacast_ide un'instructionfacoltativa fino a 600 caratteri. Viene eseguito come job (passaggi: lettura dei tuoi elementi, scrittura del copione, disegno dei primi fotogrammi), e copioni e immagini usano crediti AI.edit_cast_storyboardapplica fino a 60 modifiche in ordine:confirm,unconfirm,confirm_all,delete,delete_all,moveeset(le parole di una scena, la sua didascalia a schermo, il titolo, la cifra, i punti elenco, la citazione e il layout di una scheda, e quale conduttore dice un intervento). Una modifica non ben formata rifiuta l'intera chiamata. Risponde con i fotogrammi che ha ridisegnato.redo_cast_scenerifà una scena. Il suomodeèrewrite,picture(una nuova immagine, le parole restano),insert(una nuova scena inposition, contando da 0) okind(cambia ciò che la scena mostra:title,card,picture,stock,screenshot,presenteropodcast).instructionè fino a 600 caratteri. Viene eseguito come job, e immagini e scrittura usano crediti AI.
Creare e pubblicare
build_castcrea il file dallo storyboard confermato e lo salva nel Drive. Una scena non confermata lo rifiuta, a meno checonfirm_allsiatrue. Viene eseguito come job (passaggi: registrazione della voce, preparazione delle immagini, montaggio delle scene, missaggio dell'audio, salvataggio nel tuo Drive). Voci e immagini usano crediti AI, e una build riuscita conta nel mese.stop_cast_buildferma la build al lavoro su un pezzo.publish_castcondivide un pezzo creato.wayèlink, che attiva il link (o lo disattiva, conoffimpostato sutrue), oppureemail, che invia il link a un massimo di 10 indirizzi into, con unmessagefacoltativo fino a 1000 caratteri. Chiunque abbia il link può guardare o ascoltare finché il file non viene eliminato.quick_castcrea un video infografico rapido su un contatto, un gruppo di contatti, una chat AI o una knowledge base:target_kind(contact,contact_group,chatoknowledge_base),target_id, untarget_namefacoltativo per il titolo e unalanguagefacoltativa usata quando le impostazioni dicono Auto. Usa le impostazioni predefinite salvate nelle impostazioni. Viene eseguito come job (passaggi: lettura dell'elemento, scrittura del copione, disegno dei fotogrammi, creazione del video).
Un server crea un pezzo alla volta per tutti. Un workspace occupa al massimo due posti in quella coda, uno in creazione e uno in attesa, e un terzo viene rifiutato.
Impostazioni e piani
save_cast_settingssalva le impostazioni predefinite per i nuovi pezzi e per i video rapidi:language(autoo un codice lingua della dashboard),voiceegender,voice2egender2per il secondo conduttore,character,seconds,size(9:16,1:1,4:5o16:9),style,captions,music,quick_buildefolder. Cambiano solo le chiavi che invii.get_cast_planslegge i piani con i loro prezzi, le funzioni e i diritti, il piano in cui si trova questo account, se Cast è attivo e le build usate questo mese.cast_set_planattiva Cast, cambia il piano (plan_idècast_free,cast_starter,cast_growthocast_business), oppure lo disattiva (unplan_idvuoto, odeactivateimpostato sutrue). Disattivarlo conserva ogni video e podcast. Entrambi i metodi dei piani accettano unbilling_workspace_idfacoltativo, che conta solo quando i piani di Cast saranno gestiti per workspace.
Che cosa viene rifiutato
La dashboard dice ognuno di questi a parole accanto al controllo. Nella risposta del metodo sono un code negativo con una frase in data:
- Solo il proprietario di un workspace può creare video e podcast al suo interno. Una chat pubblica di un assistente non può.
- Cast è disattivato per l'account, oppure il numero di build del mese previsto dal piano è esaurito (una build viene rifiutata, un copione no).
- La durata, o il numero di scene, supera ciò che il piano consente.
- Il pezzo è in lavorazione. Un copione o una build è al lavoro su di esso, quindi non può essere salvato o modificato finché non termina o viene interrotto.
- Non ci sono abbastanza crediti AI per pagare un copione, un'immagine o una voce.