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.
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
application/json
curl -X POST "https://example.com/videos/string/scenes/generate"{ "data": [ { "imagePrompt": "string", "animationPrompt": "string", "narration": "string", "voiceDescription": "string", "duration": 3, "id": "string", "status": "string", "imageUrl": "http://example.com", "videoUrl": "http://example.com" } ]}Re-cut the presentation timeline POST
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`.
Get the b-roll segments GET
The b-roll timeline: one segment per stretch of the video that shows footage or a generated image instead of the base video. Each segment carries both the editable brief (what it should show) and the resolved media the pipeline picked.