Edit Scene
edit_sceneDestructiveIdempotent
Change one scene; pass only what changes. Nothing is re-rendered here: the result's regenerate_mode tells you which regenerate_scene mode applies it (none during script review, where approve_script renders everything anyway).
- narration: the exact words spoken. Use it to fix mispronounced, wrong or garbled words
(write names/numbers the way they should be said). On a rendered video Fabeo re-writes the
scene's prompts with the new line on regenerate_scene(mode='narration'). If the voice is still
wrong after that (pronunciation, a regional language or accent, gibberish), offer the user to
record the line themselves: set_scene_audio.
- visual_description: what the scene shows (setting, action, outfit, camera). Also
re-written into the prompts on regenerate_scene(mode='narration').
- positive_prompt (rendered scenes only; clip clip_index, see get_scene_prompts): write the
clip's MiniMax H3 prompt yourself for exact control. It drives BOTH picture and sound, so
it must quote the narration word for word in its audio part (the whole line for a one-clip
scene, this clip's consecutive part otherwise) -- it is rejected if it doesn't; to change
the words pass narration too. H3 style: one continuous take (no cuts or montage),
concrete subject/appearance/outfit/setting/camera motion, no on-screen text; in
reference-image scenes open with '<Subject 1> is ... in <Picture 1>'. A hand-written
prompt is kept as written (Fabeo won't overwrite it).
- keyframe (rendered scenes only): 'keep' (default); 'variant' to try a different key
frame for the clip; 'upload' to open the clip on the user's own image -- upload it first
with get_start_frame_upload_url (the clip then animates from that exact frame, so describe
motion from it in positive_prompt).
- duration_seconds: the scene's length (2-15s per clip). The clip renders exactly this long,
so shorten it to cut music, silence or garbled speech after the voiceover ends; a length
shorter than the narration needs cuts the voiceover (the result warns). Shorter scenes
also cost fewer credits. Applied by regenerate_scene(mode='clips') on a rendered video.
- start_frame_image_key / end_frame_image_key: make the scene open on, and/or land on, the
user's own pictures. Works during script review (before approve_script) and on a rendered
video. Get the key first like a reference image (upload_reference_image,
get_reference_upload_url, or get_reference_upload_page + check_reference_upload; this needs
the user's rights confirmation) -- not get_start_frame_upload_url, which is per rendered clip.
The start frame is the scene's first clip's opening picture; the end frame is where its last
clip should finish. They must be two different images; they are separate from the scene's
reference images (the people/products shown). Describe the motion between them in
positive_prompt. Check them in get_video / get_scene_prompts (start_frame, end_frame);
remove_start_frame / remove_end_frame undo. On a rendered video apply with
regenerate_scene(mode='images').Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyframe | No | 'keep' (default), 'variant' for a different key frame, or 'upload' to open the clip on the user's own start frame (see below). | keep |
| scene_id | Yes | The scene's scene_id, from get_video. | |
| video_id | Yes | The video's video_id (from create_video, list_videos or get_video). | |
| narration | No | New spoken line, word for word (see below). | |
| clip_index | No | 0-based clip within the scene (see get_scene_prompts); most scenes have one clip. | |
| positive_prompt | No | Hand-written MiniMax H3 prompt for clip clip_index; must quote the narration word for word (see below). | |
| duration_seconds | No | New scene length in seconds (2-15 per clip; see below). | |
| remove_end_frame | No | Drop the scene's end frame. | |
| remove_start_frame | No | Drop the scene's start frame. | |
| visual_description | No | New description of what the scene shows (see below). | |
| end_frame_image_key | No | reference_image_key of the picture the scene should END on (see below). | |
| start_frame_image_key | No | reference_image_key of the picture the scene should START on (see below). |