Cast library & Character Studio

Save proven characters, places, and products to an org Cast library, reuse them across videos, and design new ones in Character Studio.

Last updated August 23, 2026

Every multi-scene production builds an asset bible: reference plates and a physical description for each subject so scenes stay consistent. The Cast library makes those subjects reusable — a character you liked in one video can walk into the next one looking the same.

See Subjects & consistency for how the bible works inside a single production.

Save a subject

When a production settles, save any subject from its bible:

POST /cast   { runGroupId, subjectId, displayName?, kind? }

The save is server-verified — Wavemaker resolves the plates and DNA from the run group’s settled bible; clients never supply the images. Kinds are person, setting, or product (People / Places / Things). GET /cast lists your org’s library; DELETE /cast/{id} removes an entry, and PATCH /cast/{id}/persona edits the description.

Reuse via the Cast chip

In chat, pick up to 6 saved subjects with the Cast chip before you Send. The production seeds its bible from your saved entries: stored plates are wired in directly as image grounds — no re-mint, so the face/look you approved is the one that appears. The chip is session-scoped; a new session starts empty.

A saved subject that no longer exists (or belongs to another org) fails the run up front rather than silently substituting a stranger.

Character Studio & world modules

You can also design a subject before any production, from Settings → Cast. Four world modules cover the same People / Places / Things split:

  • Character studio — a person: name, physical DNA, optional photos
  • Look studio — a wardrobe / styling package
  • Location studio — a place
  • Object studio — a product or prop

Create for this video stamps the module into your current session; the next Send authors the bible entry from your name/DNA/photos before minting plates, then the settled result is harvested into the library like any other subject.

Reference angle packs

Library subjects carry more than one view. In Studio / Worlds each subject gets an 8-azimuth orbit (plus a text-free reference sheet); production graphs consume the front + profile pair. If some extra angles failed to generate, POST /cast/{id}/angles/regen re-derives them from the stored front plate.

Living library (auto-harvest)

Successful productions automatically harvest their People, Places, and Things into the org Studio library when the bible settles — no manual save needed. Each harvest can be undone within 24 hours (POST /cast/harvest/{eventId}/undo); after that the window closes (410). Manual POST /cast still works and always wins on conflicts.