Inserts an empty scene after afterSceneId, or appends it when no id
is given. The new scene inherits the preceding scene's
voiceDescription so one character stays consistent, and defaults to a
6 second slot with empty prompts. Free: nothing is generated until you
fill it in and regenerate its image.
Adding a scene invalidates the stitched render, so renderUrl is
cleared. A video holds at most 50 scenes.
Authorization
bearerAuth An API key created under Settings > API & Webhooks. Keys start with sf_live_.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/videos/string/scenes" \ -H "Content-Type: application/json" \ -d '{ "afterSceneId": "n1a2b3" }'{ "data": { "id": "n7g8h9", "imagePrompt": "", "animationPrompt": "", "narration": "", "voiceDescription": "Calm, low, unhurried", "duration": 5, "status": "DRAFT" }}Update schedule, destination or status PATCH
Updates any of `schedule`, `profileId`, `platforms`, `autoRefill` and `status`. Provide at least one. `schedule` carries the whole timing block. A daily frequency (`daily`, `twice-daily`, `thrice-daily`) needs exactly as many entries in `times` as it has slots; a weekly frequency (`weekly`, `twice-weekly`, `thrice-weekly`) needs the same count of day and time pairs in `schedule`. Setting one clears the other. Activating (`status: active`) is refused while anything is still missing, with `warning-publish-not-configured` naming the blockers.
Remove one scene DELETE
Removes the scene and clears the stitched render, which is now stale.