Cast
Des vidéos et des podcasts créés à partir de vos propres fichiers, contacts et chats.
Cast n'a aujourd'hui aucune méthode d'API publique. Toutes ses méthodes portent le drapeau private, donc aucune clé API ne peut en appeler une, pas même une clé à accès complet. Les méthodes ci-dessous sont celles que les écrans de Cast appellent, depuis une session connectée au tableau de bord. Elles sont listées pour que vous sachiez ce que font les écrans, pas pour être appelées depuis votre propre code.
Une vidéo ou un podcast se fait dans le tableau de bord : depuis la page de Cast, ou en faisant glisser Cast sur un contact, un groupe de contacts, un chat IA ou une base de connaissances pour une vidéo rapide. Depuis l'extérieur, seul le fichier terminé est accessible :
- Un fichier terminé est un fichier ordinaire dans votre Drive, dans le dossier défini dans les paramètres de Cast, donc tout ce que Drive propose pour les fichiers fonctionne dessus.
Chaque méthode agit pour le propriétaire de l'espace de travail et répond code 1 quand elle fonctionne. Un refus renvoie un code négatif et en donne la raison dans data. Chaque méthode accepte un workspace_id facultatif, pour agir dans un espace de travail dont vous êtes propriétaire autre que votre espace principal, et chaque méthode nécessite une session au niveau d'habilitation utilisateur.
Les pièces
Une vidéo ou un podcast est une pièce : un document avec un identifiant qui s'écrit cst_ suivi de 16 caractères hexadécimaux. Ses scènes s'écrivent sc_ suivi de 8 caractères hexadécimaux.
get_castsliste les vidéos et les podcasts de l'espace de travail, du plus récent au plus ancien. Avec la liste, elle renvoie le forfait et ses plafonds, les créations de ce mois, les valeurs par défaut enregistrées, si ce serveur peut créer, et un prix type en crédits pour chaque étape.get_castlit une pièce avec son brief, ses éléments, son storyboard et son état. Avecframesdéfini àtrue, chaque scène porte aussi l'image de sa première image sous forme d'URL de données.get_cast_framelit l'image d'une scène (cast_id,scene_id) sous forme d'URL de données.save_castcrée une pièce, ou en modifie une. Elle prendcast_id(vide, elle en crée une nouvelle),title(une ligne, jusqu'à 120 caractères),brief(type, objectif, description, langue, voix, personnage principal, durée, format, style et options ; les clés qu'elle ne connaît pas sont ignorées.voice_language, un code de langue du tableau de bord, est la langue dans laquelle les voix sont nommées tant quelanguagevautauto: les animateurs d'un podcast s'appellent par ces noms. Le tableau de bord la définit à sa propre langue quand il crée une pièce),sources(jusqu'à 20 éléments) etcopy_of, qui démarre un nouveau brouillon à partir du brief, des éléments et du storyboard d'une autre pièce. Elle est refusée tant qu'un script ou une création travaille sur la pièce.delete_castsupprime une pièce et ses images. Le fichier créé à partir d'elle reste dans votre Drive.
Un espace de travail conserve jusqu'à 200 pièces. Les éléments d'une pièce sont des fichiers et dossiers Drive, des contacts, des groupes de contacts, des chats IA, des bases de connaissances, des pilotes, des liens et des notes. Un connecteur est conservé mais ne peut pas encore être lu.
Le script et le storyboard
read_cast_referenceregarde une vidéo YouTube pour son style seul et répond ce qu'un brief en retient sousreference: son style (couleurs, polices, angles, caméra, transitions et leur durée, forme des sous-titres), son tempo (secondes par plan, coupes par minute), son rythme de parole, de courtes notes sur sa fabrication, et ce qu'elle suggère pour le brief (genre, usage, type, format, durée). Elle prendurl. Elle s'exécute comme un job (étapes : visionnage de la vidéo, lecture de son style) et utilise des crédits IA. Une création la suit quand son brief contientreferenceet questylevautreference: le script est écrit à son tempo et la construction monte avec ses transitions. Rien du contenu de la vidéo n'est conservé.write_cast_scriptécrit le script à partir du brief et des éléments : des scènes avec la première image de chacune pour une vidéo, des tours de parole pour un podcast. Elle prendcast_idet uneinstructionfacultative de 600 caractères au plus. Elle s'exécute comme un job (étapes : lecture de vos éléments, écriture du script, dessin des premières images), et les scripts et les images utilisent des crédits IA.edit_cast_storyboardapplique jusqu'à 60 modifications dans l'ordre :confirm,unconfirm,confirm_all,delete,delete_all,moveetset(les mots d'une scène, sa légende à l'écran, le titre, le chiffre, les puces, la citation et la mise en page d'une carte, et quel animateur dit un tour de parole). Une modification mal formée refuse tout l'appel. Elle renvoie les images qu'elle a redessinées.redo_cast_scenerefait une scène. Sonmodeestrewrite,picture(une nouvelle image, les mots conservés),insert(une nouvelle scène àposition, en comptant à partir de 0) oukind(change ce que la scène affiche :title,card,picture,stock,screenshot,presenteroupodcast).instructionfait 600 caractères au plus. Elle s'exécute comme un job, et les images et l'écriture utilisent des crédits IA.
Création et publication
build_castcrée le fichier à partir du storyboard confirmé et l'enregistre dans le Drive. Une scène non confirmée la refuse, sauf siconfirm_allvauttrue. Elle s'exécute comme un job (étapes : enregistrement de la voix, préparation des images, assemblage des scènes, mixage du son, enregistrement dans votre Drive). Les voix et les images utilisent des crédits IA, et une création réussie compte dans le mois.stop_cast_buildarrête la création en cours sur une pièce.publish_castpartage une pièce créée.wayvautlink, qui active le lien (ou le désactive, avecoffdéfini àtrue), ouemail, qui envoie le lien à 10 adresses au plus dansto, avec unmessagefacultatif de 1000 caractères au plus. Toute personne disposant du lien peut regarder ou écouter jusqu'à la suppression du fichier.quick_castcrée une vidéo infographique rapide sur un contact, un groupe de contacts, un chat IA ou une base de connaissances :target_kind(contact,contact_group,chatouknowledge_base),target_id, untarget_namefacultatif pour le titre, et unelanguagefacultative utilisée quand les paramètres indiquent Auto. Elle utilise les valeurs par défaut enregistrées dans les paramètres. Elle s'exécute comme un job (étapes : lecture de l'élément, écriture du script, dessin des images, création de la vidéo).
Un serveur crée une seule pièce à la fois pour tout le monde. Un espace de travail occupe au plus deux places dans cette file, une en cours de création et une en attente, et une troisième est refusée.
Paramètres et forfaits
save_cast_settingsenregistre les valeurs par défaut des nouvelles pièces et des vidéos rapides :language(autoou un code de langue du tableau de bord),voiceetgender,voice2etgender2pour le second animateur,character,seconds,size(9:16,1:1,4:5ou16:9),style,captions,music,quick_buildetfolder. Seules les clés que vous envoyez changent.get_cast_planslit les forfaits avec leurs prix, fonctionnalités et droits, le forfait de ce compte, si Cast est activé, et les créations utilisées ce mois-ci.cast_set_planactive Cast, change le forfait (plan_idvautcast_free,cast_starter,cast_growthoucast_business), ou le désactive (unplan_idvide, oudeactivatedéfini àtrue). La désactivation conserve toutes les vidéos et tous les podcasts. Les deux méthodes de forfait acceptent unbilling_workspace_idfacultatif, qui ne compte que lorsque les forfaits de Cast sont détenus par espace de travail.
Ce qui est refusé
Le tableau de bord dit chacun de ces cas en toutes lettres à côté du contrôle. Dans la réponse de la méthode, c'est un code négatif avec une phrase dans data :
- Seul le propriétaire d'un espace de travail peut y créer des vidéos et des podcasts. Un chat d'assistant public ne le peut pas.
- Cast est désactivé pour le compte, ou le nombre de créations du mois du forfait est utilisé (une création est refusée, pas un script).
- La durée, ou le nombre de scènes, dépasse ce que le forfait permet.
- La pièce est en cours de traitement. Un script ou une création travaille dessus, donc elle ne peut être ni enregistrée ni modifiée tant que cela n'est pas terminé ou arrêté.
- Il n'y a pas assez de crédits IA pour payer un script, une image ou une voix.