Aller au contenu

Cast

Des vidéos et des podcasts créés à partir de vos propres fichiers, contacts et chats.

Ouvrir Cast
Vérifié par rapport au tableau de bord le 20 novembre 2026

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_casts liste 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_cast lit une pièce avec son brief, ses éléments, son storyboard et son état. Avec frames défini à true, chaque scène porte aussi l'image de sa première image sous forme d'URL de données.
  • get_cast_frame lit l'image d'une scène (cast_id, scene_id) sous forme d'URL de données.
  • save_cast crée une pièce, ou en modifie une. Elle prend cast_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 que language vaut auto : 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) et copy_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_cast supprime 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_reference regarde une vidéo YouTube pour son style seul et répond ce qu'un brief en retient sous reference : 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 prend url. 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 contient reference et que style vaut reference : 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 prend cast_id et une instruction facultative 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_storyboard applique jusqu'à 60 modifications dans l'ordre : confirm, unconfirm, confirm_all, delete, delete_all, move et set (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_scene refait une scène. Son mode est rewrite, picture (une nouvelle image, les mots conservés), insert (une nouvelle scène à position, en comptant à partir de 0) ou kind (change ce que la scène affiche : title, card, picture, stock, screenshot, presenter ou podcast). instruction fait 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_cast crée le fichier à partir du storyboard confirmé et l'enregistre dans le Drive. Une scène non confirmée la refuse, sauf si confirm_all vaut true. 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_build arrête la création en cours sur une pièce.
  • publish_cast partage une pièce créée. way vaut link, qui active le lien (ou le désactive, avec off défini à true), ou email, qui envoie le lien à 10 adresses au plus dans to, avec un message facultatif de 1000 caractères au plus. Toute personne disposant du lien peut regarder ou écouter jusqu'à la suppression du fichier.
  • quick_cast cré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, chat ou knowledge_base), target_id, un target_name facultatif pour le titre, et une language facultative 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_settings enregistre les valeurs par défaut des nouvelles pièces et des vidéos rapides : language (auto ou un code de langue du tableau de bord), voice et gender, voice2 et gender2 pour le second animateur, character, seconds, size (9:16, 1:1, 4:5 ou 16:9), style, captions, music, quick_build et folder. Seules les clés que vous envoyez changent.
  • get_cast_plans lit 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_plan active Cast, change le forfait (plan_id vaut cast_free, cast_starter, cast_growth ou cast_business), ou le désactive (un plan_id vide, ou deactivate défini à true). La désactivation conserve toutes les vidéos et tous les podcasts. Les deux méthodes de forfait acceptent un billing_workspace_id facultatif, 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.

Que pensez-vous de ce guide ?

Dernière mise à jour le 18 novembre 2026