# Prompt patterns ## The lock The lock is one line, written from the photo, naming what must not change. It is said once in the after-still prompt. Write what you can see, not what you assume. | Kind | What the lock names | Example | |---|---|---| | `pet` | Breed look, size, coat colour and pattern, markings and which side, eyes, ears, collar | a small scruffy terrier mix about 35 cm at the shoulder, wiry tan and white coat, a black patch over the left eye of the picture, amber eyes, one ear up and one folded, a red collar | | `room` | The room, window and door positions, floor, walls, light, the camera angle | a small living room seen from the doorway, a tall window on the right, light oak floor, plain white walls, a rug in the middle | | `product` | Shape, proportions, colours, finish, label area | a matte black over-ear headphone with a plain headband and round ear cups, no logo | | `sketch` | What it shows, its shape, proportions and colours, where it sits on the page | a pencil and marker drawing of a small yellow delivery scooter in side view, centred on white paper | | `person` | Face shape, skin tone, age range, hair, glasses, build | an adult with shoulder-length wavy dark hair, light brown skin, round glasses | ## The cropped before photo `prepare-before.mjs` crops the photo to 9:16 before anything is generated. The after still is edited from that crop, so the framing is the same in both frames. A wide photo loses its sides: check that the subject is whole, and move `--focus` if it is not. ## After-still prompt anatomy (Nano Banana Pro edit) `build-requests.mjs --stage keyframe` writes this, in order: 1. **The edit.** "Edit the first reference photo into its after frame, vertical 9:16." 2. **The frame lock.** Same camera position, framing, angle, lens, background, light and phone-photo look, so a cut between the two reads as the same moment. The subject keeps its size and place. 3. **What must not change.** The lock. 4. **The change.** The reveal's after text with the user's own words in it. One change only. 5. **People.** None, or for a person: the face, hair, skin tone, age and build exactly as in the photo, styling only. 6. **The look.** Slightly imperfect phone-photo quality with the same noise and colour as the reference, not a polished studio picture. The subject in the middle of the frame. 7. **The ban.** No text, logos, watermark, loading bar, screen or interface. Write the change as a plain noun phrase: "a small red hero cape and round goggles", not "make it epic". Name colours and sizes. One reveal, one change. ## Motion prompt anatomy (draft and final) 1. **The camera.** One move at most: handheld and steady, a slow push in, a slow dolly forward or a slow glide to one side. The reveal menu has a line for each. 2. **The one action.** One small movement and a held ending: "holds the pose, then lifts its chin and turns its head to look into the camera". Kling keeps shapes best when the action is small. 3. **The keep line.** The subject keeps exactly its look from the first frame. 4. **People.** None, or only the planned person. 5. **The ban.** One continuous shot, no cuts, no fades, no flash, no white frames; no text, captions, loading bar or interface; no sound is needed. The Kling request also carries the negative prompt in `assets/generation-input.json`. The Seedance draft has no negative prompt field, so the ban is in the prompt text. ## Failure modes and fixes | You see | Cause | Fix | |---|---|---| | The after still has a different pose, angle or room layout from the before | The lock is weak, or the change invites a redo | Add "same pose" and the layout to the lock; shorten the change; re-roll | | The pet's markings, ears or eyes changed | The lock does not name them | Name the side and the pattern; use `--refs` with a second photo of the pet | | The costume covers the eyes or nose | The change did not say where it sits | "on its forehead", "round its shoulders"; re-roll | | The after still looks like a studio render beside a phone photo | The look line was dropped | Keep the "phone-photo look, same noise and colour" line; re-roll once | | Letters or logos appear on a box, a wall or a screen | The change invited branding | "plain", "unbranded", "no writing"; re-roll | | A loading bar, a white frame or a fade shows up inside the clip | The video model copied the idea from the prompt | The ban line is already in; remove any "reveal" or "flash" wording from the change; trim the first 0.2 s | | The subject does something big, then melts or morphs back | Too much action for 5 s | One small action and a held end; trim to the clean part | | A second animal or a person walks in | The camera reveals new space | Keep the camera nearly still; the people line is in the prompt; re-roll | | The room's windows or walls drift during the dolly | The move is too long | A shorter, slower dolly; trim the last second | | A sketch's real version has different colours from the drawing | The lock does not name them | Name the colours and parts in the lock | | The product is wrong, or its label has garbled letters | Weak reference | `--refs product.jpg`, "plain label area"; leave the logo off | | Seedance refuses the draft or the still | A visible realistic face, or a false alarm (it refused the sample dog in a cape and goggles as "likenesses of real people") | Skip the draft (`--no-draft`); the Kling final is the test. For the still, see `references/safety-and-likeness.md` | | The before and after look the same brightness and the cut is dull | The flash is too short | `--flash 0.35`; check the beat strip | ## Drafts and finals - The draft is Seedance 2.0 mini at 480p, 5 s, silent: about $0.36. It tests whether the action reads and the subject holds its look. It is a different model from the final, so judge the idea, not the physics. - The final is Kling 3 pro, 5 s, silent: about $0.56. Kling is the default because it keeps shapes and markings from the start frame and accepts a realistic face for the people version. - Seedance can refuse a pet or product start frame that has no person in it. Do not retry the same image: skip the draft with `--no-draft` and treat the first Kling final as the test. - The people version has no draft. The first Kling final is the test, so quote it that way. ## Fail path At most 3 attempts at each paid step, one change per attempt, and say which: the wording of the change, then the lock, then the model for the final. After three, deliver the best attempt trimmed to its clean part (`files.in` and `files.out`) and say exactly what differs from the photo. Never deliver a reveal that fails the subject, people, welfare or labelling checks in `references/output-spec.md`.