Lets the AI director re-cut the presentation into scenes from the existing transcript, picking a template, a tone and a visual for each beat, and replaces the stored timeline with the result. Charges credits.
Synchronous but slow (it plans the whole film in one pass). The video
must already have a transcript, so generate the video first; without
one the call is refused with 409 warning-source-not-ready.
Authorization
bearerAuth An API key created under Settings > API & Webhooks. Keys start with sf_live_.
In: header
Path Parameters
Header Parameters
Unique key per action (a UUID works well). Reusing it replays the first response instead of running the action again, so a retry after a timeout can never generate, render, publish or charge twice.
length <= 255Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/videos/string/presentation-scenes/generate"{ "data": [ { "id": "string", "startMs": 0, "endMs": 0, "text": "string", "emphasis": "string", "template": "string", "tone": "light", "caption": "show", "hidden": true, "visual": { "type": "string", "items": 1, "anchors": [ "string" ] }, "content": {}, "params": {}, "direction": {}, "composed": {} } ]}Remove one scene DELETE
Removes the scene and clears the stitched render, which is now stale.
Plan the AI scenes POST
Plans a whole scene list from the video's prompt: the shots, their prompts, the narration and the pacing. Charges credits. Replaces whatever scenes the video already has. AI videos only; anything else is `409` `wrong-video-type`.