Guide
Storyboard an Ad From a Script With Script Runner
Turn an ad script into scenes and a reference image per scene. A step-by-step Script Runner workflow with prompt tips, costs and how to brief a shoot.
· 5 min read
A storyboard turns a script into a sequence of pictures, one per scene, so everyone agrees on what the ad looks like before anyone films, edits or spends money. Traditionally that means sketches or a mood board pulled together by hand. Script Runner does the first draft for you: paste a script, it splits it into scenes, and it generates a reference image for each one.
This guide walks through the workflow, how to write a script that splits cleanly, and how to use the frames afterwards.
What Script Runner does
- Reads your script and splits it into scenes, each with the spoken line, a shot description and an image prompt. This costs 5 credits per script.
- Generates one image per scene with the image model you pick. Each image is billed like a normal image, for example 8 credits for a FLUX.2 klein 1K image or 4 for a FLUX.1 schnell draft.
- Lays out the frames in order, so you can review, regenerate a single scene or download the set.
It does not produce a video. AI video generation is coming soon. The storyboard is the plan you film, edit or later animate from.
Step 1: Start with a script that has clear beats
Script Runner works best when each line describes one moment. You can write the script yourself, or generate one with the UGC script writer and paste it in. A good input looks like this:
HOOK: Close-up of a cracked phone screen on a kitchen counter. "Third screen this year."
PROBLEM: Creator picks up the phone, sighs. "I kept buying thin cases because I hate bulk."
PRODUCT: Creator slides the phone into a slim matte case. "This one is barely thicker, but it has raised edges."
PROOF: Phone dropped onto a rug from hip height, creator picks it up and shows the screen. "Not a scratch."
CTA: Case on the counter next to the box. "It comes in six colors. Link below."Labels like HOOK and CTA are optional, but they help the scene split land where you expect. Put visual direction in the line itself; the model cannot guess that the creator is in a kitchen unless you say so somewhere.
Step 2: Set the look once
Before you run it, decide on aspect ratio and style. For a TikTok or Reels ad choose 9:16; for a feed ad, 4:5. Add a short style line that applies to every scene, for example: "candid smartphone photo, natural window light, warm tones, same woman in her thirties with short dark hair and a grey sweater". Repeating the same description of the person and setting is the simplest way to keep frames consistent.
Step 3: Add your product as a reference
If you use FLUX.2 klein, you can attach up to four reference images. Use a clean product photo and, if you have one, a photo of the packaging. The model then keeps your actual product closer to its real shape and colors instead of inventing a generic one. See product photo reference images for how to shoot good references with a phone.
Step 4: Review and regenerate single scenes
Read the frames in order and ask three questions per scene:
- Does the image show the moment the line describes?
- Is the product recognizable and the right way up?
- Does the person and setting match the scene before?
Regenerate only the scenes that fail. Editing one prompt is cheaper and faster than rerunning the whole script. If a scene keeps drifting, make its prompt more literal: name the camera angle ("over-the-shoulder", "top-down", "close-up on hands"), the object positions and the lighting.
What a storyboard costs
| Script | Scenes | Model | Credits |
|---|---|---|---|
| 15s UGC ad | 4 | FLUX.1 schnell 1K | 21 |
| 15s UGC ad | 4 | FLUX.2 klein 1K | 37 |
| 30s ad | 7 | FLUX.2 klein 1K | 61 |
A practical pattern is to draft with schnell, then regenerate the two or three key scenes (hook and product shots) with klein and your references. The full price list is on the pricing page, and the AI ad costs guide works through bigger batches.
Using the storyboard
Brief a creator or shoot
Export the frames with the lines underneath and send them as a shot list. Creators work faster when they can see the framing you want, and you get fewer reshoots. Keep the frames as reference only; the real footage should look like the creator's own.
Ship the frames as static ads
The hook frame and the product frame often work as image ads on their own. Add the hook as headline text and test them in feed placements while the video is in production.
Plan the edit
The scene list doubles as an edit decision list. After filming, record a voiceover from the same lines if needed, cut to the scene order and burn in captions.
Common problems
- Too many scenes: long paragraphs get split into many small moments. Shorten the script or merge lines.
- Text in images: models can garble on-screen words. Add headlines in your editor, not in the prompt.
- Hands and small objects: close-ups of hands holding tiny items are the hardest shots. Simplify the action or change the angle.
- Different people in every frame: repeat the same physical description in the style line, and keep it specific.
Script Runner is also available through the API if you want to batch storyboards for many products at once.