# Prompt patterns The keyframe decides what the object, the material and the set look like; the motion prompt decides what the blade and the pieces do; the sound line decides what the viewer hears. Approve every keyframe before any video is paid for, and hear one sound test before the finals. ## Locks Written once in reel.json and reused through tokens: - `locks.object` (`{{OBJECT}}`): the object's shape, proportions, parts and colours, without the material. "a low-top running shoe with a rounded toe, a thick cushioned sole, lace eyelets and laces, a padded collar and a pull tab at the heel, in white with soft green side panels and a green sole edge". - `locks.material_name` (`{{MATERIAL_NAME}}`): two or three words, used in later beats ("marble soap"). - `locks.material` (`{{MATERIAL}}`): the finish in one sentence, from `references/materials.md`. - `locks.inside` (`{{INSIDE}}`): what the cut face shows. - `locks.set` (`{{SET}}`): the board and the backdrop. - `locks.look`: lens and light, written by build-shot-list.mjs. Generate shot 1 first, approve it, and put its path in shot 1's `keyframe`. Shots 2 and 3 then use it as reference image 1 (and the product photo as reference image 2), so the object, material, board and light match. ## Keyframe prompt anatomy build-requests.mjs wraps your text as: "A vertical 9:16 macro still frame from a satisfying ASMR cutting video. {keyframe_prompt} {reference sentences} {logo sentence} {locks.look} Photorealistic material and true-to-life scale. No people, no faces, no animals. No text, no letters, no logos, no watermark." Write `keyframe_prompt` as: size and angle → the object and its state (whole, mid-cut, halves parting) → where the blade is → what is empty → where the object sits in the vertical frame. - First frame: "Close-up at board height, three-quarter front view: {{OBJECT}}, remade entirely in {{MATERIAL}}, resting whole and untouched in the middle of the frame on {{SET}}. No knife and no hands yet; the top fifth of the frame is empty background so a blade can enter from above." - Slice: "Extreme macro side view at board level of the same {{MATERIAL_NAME}} object as in reference image 1 … the knife blade is all the way down through it, and a thick clean slice has just begun to lean away from the blade … Only the flat of the blade and its spine show, entering from the top edge; no hand in frame." - Reveal: "Close-up straight on to the cut face … the halves are just starting to part, showing the inside: {{INSIDE}}. No knife and no hands in frame." Image models: `fal-ai/nano-banana-pro/edit` (`image_urls`, `aspect_ratio` "9:16", `resolution` "2K", same $0.15 as 1K, about 1536 × 2752) for every frame with a reference; `openai/gpt-image-2` (`image_size` 864 × 1536, `quality` "medium") for the first frame when there is no photo. Veo wants a 9:16 image of 720p or more; both are above it. ## Motion prompt anatomy (Veo 3.1 fast image-to-video) build-requests.mjs builds: "Satisfying ASMR macro video, vertical 9:16, one continuous shot, no cuts, slow and smooth, real-time speed. {motion_prompt} Sound: close-miked, studio quiet, {sound}; nothing else. No music, no voices. {hand line} No text, no people, no faces." The hand line depends on the shot: when the motion prompt mentions a glove, "The gloved hand stays at the top edge of the frame, well away from the cutting edge; no other hand appears."; otherwise "No hands in frame." Never mention a hand in a shot that has none: naming it invites it. Write `motion_prompt` as: what enters and from where → the single action → what stays still → the camera. - "A wide, polished stainless steel chef's knife held by a hand in a black nitrile glove that stays cropped by the top edge of the frame … enters from the top edge of the frame within the first second, lines up, and presses straight down into the object, cutting one clean, thick slice off one end in a single smooth stroke. The object stays perfectly still on the board. The camera is locked off with a very slight slow push-in." - "The thick slice peels away from the blade and tips over slowly, falling flat onto the board with a small natural bounce; the blade lifts straight up and out of the top of the frame." - "The two halves slowly fall open to either side and settle on the board, revealing the whole cut face … The camera pushes in very slowly on the cut face and holds still for the last second." Camera moves that work in 6 s of macro: locked off, a very slight push-in, a slow push that stops. Avoid orbits, handheld shake, rack focus pulls and anything "fast". ## Sound lines Veo 3.1 makes sound from the prompt. What works: - One sound per beat, named by its quality and its cause: "one crisp, glassy crunch as the blade bites and slides through". - "close-miked, studio quiet … nothing else. No music, no voices." Without it Veo may add a music bed or a soft voice. - The `negative_prompt` repeats the guards: "music, singing, voices, speech, whispering, breathing, people, faces, bare hands, bare skin, fingers near the blade, blood, animals, text, captions, subtitles, letters, logos, watermark, cuts, scene change". - Avoid words that read as voices in the sound line itself ("whisper", "sigh"). ## Failure modes and fixes | You see or hear | Cause | Fix | |---|---|---| | A bare hand, or fingers near the blade | Hand not pinned | Keep "black nitrile glove … cropped by the top edge"; re-roll; if it persists, remove the hand and let the blade enter alone | | A second hand steadies the object | The model's idea of cutting | "The object stays perfectly still on the board" and "no other hand appears" (already in the prompt); re-roll | | The object heals, or the slice rejoins | Too much time after the action | Trim before it happens; ask for "a still hold" at the end | | The cut goes the wrong way or splits the whole object in beat 1 | Vague slice | Say where: "a thick slice off the toe end", "a round off one end" | | The inside changes from beat 2 to beat 3 | `locks.inside` not specific | Name the pattern and colours; check the beat 3 keyframe shows it before animating | | Glass shatters or shards fly | "Glass" read as real glass | "cuts cleanly like soft butter, no shards, no cracks" | | Jelly melts or collapses | Too much wobble asked | "wobbles slightly and holds its shape" | | Music, a voice, breathing | Sound line too open | Add "nothing else. No music, no voices." (built in) and the negative prompt; re-roll the clip | | Two cut sounds, or the sound late | Two actions, or the action late | "one single cut", "enters within the first second" | | Text, letters or a garbled logo | Label area or a prompt word | "Leave any label or logo area plain, with no letters" (built in); re-make the keyframe | | The frame is refused (`content_policy_violation`) | Reads as unsafe knife handling, a person, an animal or a brand | Re-make the keyframe: gloved hand cropped or no hand, nothing alive, plain label | | The object looks different between beats | Weak reference | Re-make the later keyframe with the approved first frame as reference 1; keep the same set words | ## Fail path Max 3 attempts per shot. Change one thing each time and say which: the motion prompt, the sound line, the trim, or the keyframe. View each attempt's contact sheet next to its keyframe and listen to it. After three, use the best attempt trimmed to its clean part and tell the user what still differs. ## Other video models - Veo 3.1 (`fal-ai/veo3.1/image-to-video`, $0.40/s with audio): the same fields, finer detail, about 2.7 times the price. Worth it only for a hero product reel. - Seedance 2.5 (`bytedance/seedance-2.5/image-to-video`, $0.473/s at 720p, audio at the same price) also makes sound, and takes an `end_image_url`, but costs about three times as much as Veo 3.1 fast. Use it if Veo keeps refusing a frame. - Silent models (Kling, Seedance 2.0 mini) lose the point of the format: no cutting sound. Do not use them for the finals.