Talk to the video director
studio_video_messageOne turn of the film's conversation with its director. The conversation turn is free; when an active persistent editing cap authorizes a requested paid edit, that edit may start without another Make approval and reports spend_pending plus editing_budget. Say what the film should be, or what to change, in the user's words: the scenes, their words, the music, the voice, captions, the style, the length, its playback speed, a scene made again or with a new person in it. (A plain speed change on a finished film — "make it 1.25x" — is set_studio_video_speed: free, one call per film.) The director writes and edits the film's storyboard straight away — except that a bare idea with no storyboard yet ("a reel for my bakery") may be talked through first: up to three short replies, one question each, before it writes; "just make it" or "decide for me" skips that. Every draft change is free and can be undone (edit_studio_video_storyboard undo, or revert_turn with the turn_id this returns). The turn itself is free. It may queue a requested paid edit when an active persistent editing budget authorizes it; that edit reports spend_pending and editing_budget with its actual charge. Without an active cap, no paid edit is queued from this connector turn. The film's initial make still uses the one button, which get_studio_video shows with its price, and only make_studio_video presses it. If the user asks to make the initial film in chat and no persistent cap is active, propose make_studio_video with the button's quote_hash and credits so the price is shown ON the card; otherwise confirm the price with them in words first, then call it. A requested paid edit within an active cap is handled by this turn and does not need another Make card. On a film made from their own video, ask here for new scenes before or after their clip (e.g. "a 14-second motion-graphics ending after my clip"): the director adds them to the same film at their price, joined into one export — never a second film to join. On their own talking footage, ask here for words on screen too — e.g. "split the big words around me, behind me": one phrase they say, set huge in two halves that frame them and pass behind them (the cut-out behind them is the one priced part of that plan). Returns the director's reply, changes (the edits it applied, each { id, summary }), turn_id when it changed anything, and ask when it has a question: answer with answer: { question_id, option_id }. ask.ideas offers three ideas (pick one by its option_id, or ignore them and keep talking); ask.scope asks whether a change is for one scene or all like it (scope:this / scope:all); ask.intake_form asks everything still missing at once (see its how_to_answer). Answers within about 40 seconds: a turn that takes longer answers still_working: true with asked_at — do NOT send the message again; poll get_studio_video until last_reply_at is later than asked_at, and read the reply, question, storyboard and button there.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| answer | No | Answer to the option card from `ask` | |
| message | No | What the user wants, in their words. Pass on what they said and any concept or script they agreed; never add a visual style, treatment or medium they did not ask for (live film 408e93ad, 1 Nov 2026: "a video ad" was sent as "a motion-graphics video ad" and made as moving type). The director decides what each scene is made of. | |
| 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. | |
| concept_id | No | Develop this idea from a `concepts` plan | |
| project_id | Yes | Project id from create_motion_project. The bare project id or the library id ("studio-video:<uuid>" from list_creations / find_creation) both work. |