Skip to content

Cast

Videos and podcasts made from your own files, contacts and chats.

Open Cast
Checked against the dashboard on November 20, 2026

Cast has no public API methods today. Every method it has carries the private flag, so no API key can call one, not even a key with full access. The methods below are what the Cast screens call, from a signed-in dashboard session. They are listed so you know what the screens do, not as something to call from your own code.

A video or a podcast is made in the dashboard: from Cast's own page, or by dragging Cast onto a contact, a contact group, an AI chat or a knowledge base for a quick video. From outside, only the finished file is within reach:

  • A finished file is an ordinary file in your Drive, in the folder set in Cast's settings, so what Drive offers for files works on it.

Each method acts for the owner of the workspace and answers code 1 when it works. A refusal answers a negative code and says why in data. Every method takes an optional workspace_id, to act in a workspace you own other than your home one, and every method needs a session at user clearance.

The pieces

A video or a podcast is a piece: one document with an id that reads cst_ followed by 16 hex characters. Its scenes read sc_ followed by 8 hex characters.

  • get_casts lists the workspace's videos and podcasts, newest first. With the list it answers the plan and its caps, this month's builds, the saved defaults, whether this server can build, and a typical credit price for each step.
  • get_cast reads one piece with its brief, items, storyboard and state. With frames set to true, each scene also carries the picture of its first frame as a data URL.
  • get_cast_frame reads the picture of one scene (cast_id, scene_id) as a data URL.
  • save_cast creates a piece, or changes one. It takes cast_id (empty creates a new one), title (one line, up to 120 characters), brief (kind, purpose, description, language, voice, main character, length, size, look and options; keys it does not know are dropped. voice_language, a dashboard language code, is the language the voices are named in while language is auto: a podcast's hosts call each other by those names. The dashboard sets it to its own language when it makes a piece), sources (up to 20 items) and copy_of, which starts a new draft from another piece's brief, items and storyboard. It is refused while a script or a build is at work on the piece.
  • delete_cast deletes a piece and its frames. The file built from it stays in your Drive.

A workspace keeps up to 200 pieces. A piece's items are Drive files and folders, contacts, contact groups, AI chats, knowledge bases, pilots, links and notes. A connector is kept but cannot be read yet.

The script and the storyboard

  • read_cast_reference watches a YouTube video for its style alone and answers what a brief keeps of it as reference: its look (colours, type, corners, camera, transitions and how long they take, caption shape), its tempo (seconds a shot, cuts a minute), its speaking pace, short notes on how it is made, and what it suggests for the brief (kind, purpose, type, shape, length). It takes url. It runs as a job (steps: watching the video, reading its style) and uses AI credits. A piece follows it when its brief holds the reference and style is reference: the script is written to its tempo and the build cuts with its transitions. Nothing of the video's content is kept.
  • write_cast_script writes the script from the brief and the items: scenes with the first frame of each for a video, turns for a podcast. It takes cast_id and an optional instruction of up to 600 characters. It runs as a job (steps: reading your items, writing the script, drawing the first frames), and scripts and pictures use AI credits.
  • edit_cast_storyboard applies up to 60 changes in order: confirm, unconfirm, confirm_all, delete, delete_all, move and set (a scene's words, its on screen caption, a card's headline, figure, bullets, quote and layout, and which host says a turn). A change that is not well formed refuses the whole call. It answers the frames it drew again.
  • redo_cast_scene redoes one scene. Its mode is rewrite, picture (a new picture, the words kept), insert (a new scene at position, counting from 0) or kind (change what the scene shows: title, card, picture, stock, screenshot, presenter or podcast). instruction is up to 600 characters. It runs as a job, and pictures and writing use AI credits.

Building and publishing

  • build_cast builds the file from the confirmed storyboard and saves it to the Drive. A scene that is not confirmed refuses it, unless confirm_all is true. It runs as a job (steps: recording the voice, preparing the pictures, putting the scenes together, mixing the sound, saving to your Drive). Voices and pictures use AI credits, and a build that succeeds counts against the month.
  • stop_cast_build stops the build at work on a piece.
  • publish_cast shares a built piece. way is link, which turns the link on (or off, with off set to true), or email, which sends the link to up to 10 addresses in to, with an optional message of up to 1000 characters. Anyone with the link can watch or listen until the file is deleted.
  • quick_cast makes a quick infographic video about a contact, a contact group, an AI chat or a knowledge base: target_kind (contact, contact_group, chat or knowledge_base), target_id, an optional target_name for the title, and an optional language used when the settings say Auto. It uses the defaults saved in the settings. It runs as a job (steps: reading the item, writing the script, drawing the frames, building the video).

One server builds one piece at a time for everybody. A workspace holds at most two places in that line, one building and one waiting, and a third is refused.

Settings and plans

  • save_cast_settings saves the defaults for new pieces and for quick videos: language (auto or a dashboard language code), voice and gender, voice2 and gender2 for the second host, character, seconds, size (9:16, 1:1, 4:5 or 16:9), style, captions, music, quick_build and folder. Only the keys you send change.
  • get_cast_plans reads the plans with their prices, features and entitlements, the plan this account is on, whether Cast is switched on, and the builds used this month.
  • cast_set_plan switches Cast on, changes the plan (plan_id is cast_free, cast_starter, cast_growth or cast_business), or switches it off (an empty plan_id, or deactivate set to true). Switching off keeps every video and podcast. Both plan methods take an optional billing_workspace_id, which only matters once Cast's plans are held per workspace.

What is refused

The dashboard says each of these in words next to the control. In the method's answer they are a negative code with a sentence in data:

  • Only the owner of a workspace can make videos and podcasts in it. A public Assistant chat cannot.
  • Cast is switched off for the account, or the plan's number of builds in the month is used (a build is refused, a script is not).
  • The length, or the number of scenes, is past what the plan allows.
  • The piece is being worked on. A script or a build is at work on it, so it cannot be saved or edited until it ends or is stopped.
  • There are not enough AI credits to pay for a script, a picture or a voice.

How is this guide?

Last updated on November 18, 2026