# Output spec ## Deliverables | File | Format | Size | Notes | |---|---|---|---| | `stunt.json` | JSON | | The plan: locks, prompts, sounds, keyframe and clip paths, trims, tag. | | `keyframes/01-wide.jpg`, `keyframes/02-hero.jpg` | JPEG | about 1536 x 2752 (Nano Banana Pro 2K, 9:16) | One approved still per shot. Shot 1 is also the cover image. | | `drafts/NN-draft-1.mp4` | MP4, silent | 480p, 5 s | Optional motion tests. | | `clips/NN-final-kling-1.mp4` | MP4 H.264 with sound | 1072 x 1928 (Kling, as returned in the sample run) or 720 x 1280, 5 s | One clip per shot. | | `-stunt.mp4` | MP4 H.264 yuv420p, 24 fps, AAC 192 kbps, +faststart | 720 x 1280 | 8 to 9.7 s (the sample run was 8.0 s), one hard cut, sound on, AI-made tag on. | | `-stunt-4x5.mp4` (optional) | MP4 | 720 x 900 | Centre crop for feed posts (`--crop 4:5`), tag redrawn for the crop. | | `-stunt.mp4.edl.json` | JSON | | Edit list: shot starts, trims, the cut, the audio crossfade, the tag and its box. | | `preview.mp4` (optional) | MP4, no audio | under 7.5 MB | Silent web preview (`--audio none --max-mb 7.5`), tag included. | Default settings: keyframes on `fal-ai/nano-banana-pro/edit` (`aspect_ratio` "9:16", `resolution` "2K", JPEG) from the product photo; drafts on `bytedance/seedance-2.0/mini/image-to-video` (480p, 5 s, silent); finals on `fal-ai/kling-video/v3/pro/image-to-video` (`start_image_url`, `duration` "5", `generate_audio` true, the negative prompt in `assets/generation-input.json`); assembly with trims 0.1 to 5.0 s, one hard cut, 0.08 s audio crossfade, 0.4 s audio fade-out, grade `clean`, the tag "AI-made" top-left, CRF 20. ## Approximate cost (fal list prices, checked 2026-11-13) | Step | Cost | |---|---| | Keyframes, 2 x Nano Banana Pro edit | $0.30 | | Drafts, 2 x 5 s Seedance 2.0 mini 480p silent ($0.0721/s) | $0.72 | | Finals, 2 x 5 s Kling 3 pro with sound ($0.168/s) | $1.68 | | Without re-rolls | $2.70 | | **Quote** (one re-rolled keyframe $0.15 and one re-rolled final $0.84) | **about $3.70** | | Seedance 2.5 720p finals instead of Kling ($0.473/s) | about $5.75 without re-rolls | `build-requests.mjs --stage estimate` prints this for the real plan. Quote its total and get one yes before the first paid call. Skipping the drafts saves $0.72. The finals must have sound: a silent street clip loses half of its effect. ## Sound - Made by the video model with the picture: street, tram or harbour ambience, a soft crowd murmur with no words, the product's own sound. No music, no speech, no sirens. - `assemble-stunt.mjs` joins the clips' sound with a 0.08 s crossfade (the second clip starts its sound 0.08 s early, so only sound the picture never shows is blended) and fades out over the last 0.4 s. - Listen to the whole clip before it ships. Re-roll a shot, or deliver muted, if there is music, a voice, a siren or a sound that does not match the picture. If the user wants music they add it in the app from the licensed library. ## Checklist Technical (`scripts/check-stunt.mjs --file -stunt.mp4 --edl -stunt.mp4.edl.json --resolution 720p`, exit code 0): 1. 8 to 11 s (the sample run: 8.0 s); 9:16; 720p; H.264 yuv420p; 24 fps; +faststart. 2. The AI-made tag is in the edit list and white tag text is found in its box at the start and the end. (A sanity signal only: look at the frame yourself.) 3. An audio track that is not silent; every shot peaks above -40 dBFS; nothing above -0.3 dBFS. 4. No black frames; no brightness jumps outside the planned cut (or each one looked at and passed with `--ignore`). 5. Web preview: no audio track, under 8 MB (`--muted --max-mb 8`). By eye and ear (contact sheet, then the clip twice with sound): 6. **Product locked.** The same product in both shots: shape, proportions, parts and colours as in the photo, the same size against the buildings, nothing added or changed. 7. **Looks placed.** A real-looking street, the same buildings and light in both shots, true shadows and contact, perspective that makes it feel huge. 8. **The beat.** The wide shot says where and how big; the hero shot lands as a low-angle, towering moment and holds. 9. **Nothing branded.** No readable text, logos, brand names, vehicle badges or number plates anywhere but, at most, the user's own logo spelled exactly as in the photo. No real landmark. 10. **Nothing damaged, nobody scared.** No debris, cracks, smoke, fire, spray on people or emergency vehicles. People are calm, small and far away. 11. **Faces unreadable.** No person is clear enough to recognise, and none is a close-up. 12. **Phone-clip look.** Handheld, wide, level or low. No CCTV, news, dashcam, timestamp or banner. 13. **The tag.** "AI-made" is in the top-left below the app bar, readable at phone size, on every frame, and does not cover the product. 14. **Safe zones.** The product and the action sit in the middle 60% of the frame (clear of the top 12% and bottom 20%). 15. **Sound.** Street sound you can hear, in sync with the picture; no music, speech or sirens. 16. **Cover image:** the wide keyframe, or a frame from the hero shot, with the tag. If check 6, 9, 10, 11 or 13 fails, never deliver the clip as finished. Follow the fail path in `references/prompt-patterns.md`. ## Seen in the sample run (so you know what to look for) - Kling invents writing on a blank billboard after about 3 s in the hero shot: trim before it (check 9). Look at the top-right edge of the panel. - A tiny, unreadable number plate can remain on a distant car in the keyframe (check 9). Zoom in; if a letter is legible, re-roll the keyframe. - Tiny pedestrians can pop in at the bottom edge of the hero shot and read as dark specks (check 10). Acceptable when small and calm; re-roll or trim if they look like a glitch. - Sound: a rumble and wind with street noise. The sample run was checked on a spectrogram and by level, not by ear, so listen before you ship. ## Posting note for the user Post it with the platform's AI label switched on and a caption that says it is CGI (`assets/caption-template.md`). Never present it as a real installation.