Vai al contenuto

Cast

Video e podcast creati dai tuoi file, contatti e chat.

Apri Cast
Verificato rispetto alla dashboard il 20 novembre 2026

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_casts elenca 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_cast legge un pezzo con il suo brief, gli elementi, lo storyboard e lo stato. Con frames impostato su true, ogni scena porta anche l'immagine del suo primo fotogramma come data URL.
  • get_cast_frame legge l'immagine di una scena (cast_id, scene_id) come data URL.
  • save_cast crea un pezzo, oppure ne modifica uno. Accetta cast_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 quando language è 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) e copy_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_cast elimina 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_reference guarda un video YouTube solo per il suo stile e risponde ciò che un brief ne conserva come reference: 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). Accetta url. 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 la reference e style è 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_script scrive il copione dal brief e dagli elementi: scene con il primo fotogramma di ciascuna per un video, interventi per un podcast. Accetta cast_id e un'instruction facoltativa 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_storyboard applica fino a 60 modifiche in ordine: confirm, unconfirm, confirm_all, delete, delete_all, move e set (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_scene rifà una scena. Il suo mode è rewrite, picture (una nuova immagine, le parole restano), insert (una nuova scena in position, contando da 0) o kind (cambia ciò che la scena mostra: title, card, picture, stock, screenshot, presenter o podcast). instruction è fino a 600 caratteri. Viene eseguito come job, e immagini e scrittura usano crediti AI.

Creare e pubblicare

  • build_cast crea il file dallo storyboard confermato e lo salva nel Drive. Una scena non confermata lo rifiuta, a meno che confirm_all sia true. 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_build ferma la build al lavoro su un pezzo.
  • publish_cast condivide un pezzo creato. way è link, che attiva il link (o lo disattiva, con off impostato su true), oppure email, che invia il link a un massimo di 10 indirizzi in to, con un message facoltativo fino a 1000 caratteri. Chiunque abbia il link può guardare o ascoltare finché il file non viene eliminato.
  • quick_cast crea un video infografico rapido su un contatto, un gruppo di contatti, una chat AI o una knowledge base: target_kind (contact, contact_group, chat o knowledge_base), target_id, un target_name facoltativo per il titolo e una language facoltativa 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_settings salva le impostazioni predefinite per i nuovi pezzi e per i video rapidi: language (auto o un codice lingua della dashboard), voice e gender, voice2 e gender2 per il secondo conduttore, character, seconds, size (9:16, 1:1, 4:5 o 16:9), style, captions, music, quick_build e folder. Cambiano solo le chiavi che invii.
  • get_cast_plans legge 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_plan attiva Cast, cambia il piano (plan_id è cast_free, cast_starter, cast_growth o cast_business), oppure lo disattiva (un plan_id vuoto, o deactivate impostato su true). Disattivarlo conserva ogni video e podcast. Entrambi i metodi dei piani accettano un billing_workspace_id facoltativo, 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.

Come ti sembra questa guida?

Ultimo aggiornamento il 18 novembre 2026