Create a video project
create_motion_projectStart a film (does not spend credits). Returns project.id. Optional, as on the Video tool's start screen: kind (ad, reel, explainer, talking_head, polish) brings that kind's usual length, shape, voice and captions; format is a ready format's slug and recipe_id one of the brand's saved recipes, both from list_studio_video_templates (a recipe carries its own kind, so do not send both); look is what the film is made of — filmed (generated footage), photo (the photos of the brand moving in 3D), motion (motion graphics — the director decides from the brief whether to draw it scene by scene or cut it to the music as one film, and can show the product in use), kinetic (motion graphics cut to the music, chosen outright), website (the real site of the brand on screen) or auto (decided per scene, the default). Next, describe the film with studio_video_message: the director writes its storyboard, edits to it are free and undoable, and get_studio_video shows it with the price of making it; make_studio_video makes it once the user agrees to that price. Poll get_studio_video until ready. The same film is visible to the owner in Creative Studio. THEIR OWN VIDEO (a talking head, a recording, clips to cut together): send from instead of kind/format/recipe/look — one of video_url (an https link to an MP4, WebM or MOV up to 80 MB; it is stored in the brand's Library first), asset_id (a video from list_brand_assets), asset_ids (several, in order: a rough cut, joined with join_studio_video_cut — a finished film's project_id counts as a clip too, its export joined as it is, so two finished films are joined without re-opening either), post_id (a calendar post's video) or cut_of (a joined cut's project id). Free: the clip is read and put on the timeline; then studio_video_message says what to do with it (clean the voice, captions, motion graphics cut to what they say, a new background, presenter or voice, or NEW SCENES before or after their clip — drawn motion-graphics beats on the same timeline, joined into one export, never a separate film) and the director prices it — nothing is charged until approve_studio_video_plan. title names the film (otherwise it is named after the clip).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Make the film from their own video — exactly one of its fields | |
| kind | No | What the film is for | |
| look | No | What the film is made of. Only when the user named it ("motion graphics", "AI footage", "filmed"); otherwise leave it out and the director decides per scene. Never infer a look from a concept, a static ad or your own taste. | |
| title | No | ||
| format | No | A template `slug` from list_studio_video_templates | |
| brand_id | Yes | Brand workspace id from list_brands | |
| recipe_id | No | A recipe `id` from list_studio_video_templates | |
| user_goal | No | Optional: the user's goal behind this call, in one short sentence of plain words (e.g. "add a page so customers can book tables"). No names, emails or other personal details. | |
| aspect_ratio | No | e.g. 9:16, 16:9, 1:1 | |
| duration_seconds | No |