# Output spec ## Deliverables | File | Format | Size | Notes | |---|---|---|---| | `reel.json` | JSON | | The filled shot list: locks, prompts, sounds, keyframe and clip paths, trims. | | `keyframes/NN-beat.jpg` | JPEG | about 1536 × 2752 (Nano Banana Pro 2K, 9:16) or 864 × 1536 (GPT Image 2, first frame with no photo) | One approved still per beat. Shot 1 is the whole object: the loop frame and the cover. | | `clips/01-first-cut-test-1.mp4` | MP4 | 720 × 1280, 4 s | The sound test. | | `clips/NN-beat-final-1.mp4` | MP4 H.264 with sound | 720 × 1280, 6 s | One Veo 3.1 fast clip per beat. | | `-asmr.mp4` | MP4 H.264 yuv420p, 24 fps, AAC 192 kbps, +faststart | 720 × 1280 | About 17.7 s, text-free, sound on, last frame equal to the first. | | `-asmr-4x5.mp4` (optional) | MP4 | 720 × 900 | Centre crop for feed posts (`--crop 4:5`). | | `-asmr.mp4.edl.json` | JSON | | Edit list: beat starts, trims, cuts, audio crossfades, the loop tail. | | `preview.mp4` (optional) | MP4, no audio | under 8 MB | Silent web preview (`--audio none --max-mb 7.5`). | Default settings: first frame on `fal-ai/nano-banana-pro/edit` with the product photo (`aspect_ratio` "9:16", `resolution` "2K", JPEG) or `openai/gpt-image-2` (864 × 1536, `quality` "medium") without; shots 2 and 3 on `fal-ai/nano-banana-pro/edit` with the first frame as reference 1; video on `fal-ai/veo3.1/fast/image-to-video`, `aspect_ratio` "9:16", `resolution` "720p", `generate_audio` true, `duration` "4s" for the test and "6s" for the finals, the negative prompt from `references/prompt-patterns.md`; assembly with trims 0.1-6.0 s, hard cuts, 0.08 s audio crossfades, grade `clean`, loop tail 0.5 s, CRF 20. ## Approximate cost (fal list prices, checked 2026-11-09) | Step | With a product photo | No photo | |---|---|---| | First frame | $0.15 (Nano Banana Pro edit) | about $0.07 (GPT Image 2 medium, token-billed) | | Shots 2 and 3 | $0.30 | $0.30 | | Sound test, 4 s Veo 3.1 fast with audio | $0.60 | $0.60 | | Finals, 3 × 6 s Veo 3.1 fast with audio ($0.15/s) | $2.70 | $2.70 | | Without re-rolls | $3.75 | $3.67 | | **Quote** (one re-rolled final and one re-rolled still, $1.05) | **about $4-5** | **about $4-5** | `build-requests.mjs --stage estimate` prints this for the real shot list; quote its total and get one yes before the first paid call. Veo 3.1 fast costs the same at 1080p ($0.15/s with audio, $0.10/s silent); 4K is $0.35/s with audio. The finals must have sound: a silent cutting reel misses the point. ## Sound - The sound is made by Veo with the picture: one sound per beat, close-miked, no music, no voices. It is part of the format, so the reel is delivered with sound on, unlike the silent film Skills. - `assemble-reel.mjs` joins the clips' sound with 0.08 s crossfades. Each clip after the first starts its sound 0.08 s early, so the crossfade only blends sound the picture never shows, and every cut sound lands exactly on its frame. The first 0.03 s fades in; the loop tail fades out to silence, so the loop seam is quiet. - No added music. If the user wants music, they add it in the app from its licensed library, at a low level under the cut sounds. - Listen to the whole reel before it ships. Cut or re-roll a clip with music, a voice, breathing, or a sound that does not match the picture. ## Checklist Technical (`scripts/check-reel.mjs --loop`, exit code 0): 1. 15-20 s (about 17.7 s); 9:16; 720p (or 1080p if asked); H.264 yuv420p; 24 fps; +faststart. 2. An audio track that is not silent; every beat peaks above -35 dBFS; nothing above -0.3 dBFS (clipping). 3. The last frame matches the first (SSIM 0.97 or more). 4. No black frames; no brightness jumps outside the cuts and the loop tail (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 reel twice with sound, once on a loop): 6. One object in one material in all three beats: the same shape, colours, board, backdrop and light. 7. For a product: the shape and colours match the photo; the label is plain, or the logo is exact letter for letter. 8. The knife enters from the frame edge; the hand is in a black glove and cropped by the top edge, or absent; no bare hand, no second hand, fingers never near the blade; the blade never points at the camera. 9. No people, faces, animals or extra objects appear. 10. The cut is clean (no shards, no collapse); the slice falls naturally; the inside matches `locks.inside`; nothing heals or rejoins. 11. One clear sound per beat, in sync; no music, voices or breathing. 12. No text, letters, watermarks or garbled logos anywhere. 13. The object and the cut face sit in the middle 60% of the frame height (clear of the top 12% and the bottom 20%). 14. The loop reads as a reset, not a glitch: the board, backdrop and light do not jump at the seam. 15. Cover image: the first keyframe (the whole object). If a check fails: max 3 attempts per shot, change one thing per attempt and say which, compare each attempt with its keyframe, then deliver the best and say plainly what still differs.