Create Video Agent Session
One-shot video generation from a prompt — agent handles scripting, avatar selection, scene composition, and rendering. Supports generate (fire-and-forget) and chat (multi-turn) modes.
Body
Request body for creating a video from a prompt using Video Agent v3.
All configuration is flat (no nested config object). Files use the type-discriminated AssetInput union for flexible asset inputs.
Supports two modes:
generate(default): one-shot — auto-proceeds through storyboard, produces one video.chat: multi-turn — may pause for user input on real decisions (e.g. pick a voice), auto-proceeds on confirmations. Allows follow-up messages, targeted edits, and additional videos.
Brand glossary ID controlling how custom terms are pronounced in the generated video's narration (for example, saying 'HeyGen' as 'hey-jen'). Pronunciation is applied to the synthesized audio only, so caption and subtitle text still show the original script wording. Discover IDs via GET /v3/brand-glossaries.
1Who can open the session. private: the owner only. space: everyone in the workspace can open and drive the session. selected: the owner plus the workspace members listed in members. Defaults to space. Applies to the session and its conversation; does not change existing sessions.
private, space, selected 
