Skip to main content

Frames Guidelines

Welcome to the advanced workflow for Frames. This guide details how to transform your written screenplay into a professional visual storyboard. You will learn to configure shot budgets, manage assets, and optimize your settings to get the best visual results from the NB Pro model.

4.1 The Creation Workflow​

The system uses a five-step process to turn text into images:

  1. Assets Setup: Scans script for characters, locations, and props.
  2. Visual Descriptions: Generates detailed attributes for every entity found.
  3. Scene Breakdown: Divides the script into scenes and assigns shot counts.
  4. Shot Planning: Creates a shot-by-shot breakdown (angles, sizes, actions).
  5. Storyboard Generation: Renders the final high-quality images.

4.2 Storyboard Planning: Shot Budgets​

Understanding Shot Budgets​

What is a Shot Budget?
Your shot budget determines how many shots will be created for your entire script. Think of it as the total number of images in your visual storyboard. The system distributes these shots across scenes based on their visual complexity and narrative importance.

  • Short scripts (under 10 pages): 20–50 shots
  • Medium scripts (10–30 pages): 50–150 shots
  • Long scripts (30+ pages): 150–500+ shots
  • Action-Heavy: 150+ shots, 5–20 per scene (more for action sequences)
  • Dialogue-Heavy: 50–100 shots, 3–10 per scene (focus on reactions and key moments)

Shots Per Scene​

  • Minimum: 3 shots per scene (system default)
  • Maximum: 15–30 shots per scene (adjustable)
  • Action sequences: Need more shots (8–15 per scene) to show movement and choreography
  • Dialogue scenes: Need fewer shots (3–8 per scene) focusing on reactions and key moments

Tip: System automatically balances shots. Very long scenes may split into multiple parts.

Processing & File Limits​

  • Generation Modes: Parallel (faster) or Sequential (for visual continuity)
  • Processing: Up to 4 images simultaneously, one project at a time
  • Model: Nano Banana Pro (high-quality, photorealistic)
  • File Size: Maximum 20 MB
  • Child Characters: System automatically adjusts prompts for safe contexts to prevent moderation issues

4.3 Asset Management (Assets creation post analyzing the script)​

Before generating images, the system extracts and defines the elements of your story.

🎥 Characters​

What is detected:
Named characters with dialogue or major actions. (Generic "Crowds" are ignored unless pivotal).

Name Handling:
"Dr. Smith" and "Smith" are automatically combined into one character.

Child Characters:
The system automatically safeguards prompts for children to ensure safe, everyday contexts (school, family) and avoid moderation blocks.

Best Practice for Descriptions:

  • Write 5–7 detailed sentences.
  • Include ethnicity/race, age, body type, height, skin tone, and personality.

Note on Consistency:
The system tracks physical traits (face/body) separately from outfits to maintain likeness across shots.

📍 Locations & Sets​

Detection Logic:
Looks for standard scene headings.

Naming Format:

  • Bad: INT. APARTMENT
  • Good: INT. JOHN'S APARTMENT - NIGHT - RAINING

Variations:
The same location with different weather/time (e.g., Snow vs. Rain) creates distinct assets.

Best Practice for Descriptions:

  • Write 5–7 detailed sentences.
  • Cover size, layout, era, lighting, and key fixed objects.

📦 Props​

What is detected:
Items touched/used by characters or critical to the plot. (Walls, doors, and static furniture are usually part of the Location).

Best Practice for Descriptions:

  • Write 5–7 detailed sentences regarding materials, condition, and functionality.

4.4 Scene Breakdown​

The system analyzes your script structure to maintain visual flow.

  • Natural Breaks: A new sequence starts at every INT./EXT. change.
  • Montages & Phone Calls: INTERCUT scenes or Montages are treated as a single sequence to maintain flow, even if locations shift.
  • Multi-Location Scenes: The system acts like a film editor, alternating shots between locations. Characters only appear in their designated space.
  • Long Scene Splitting: If a scene is too long, the AI finds natural breaks (pauses, topic changes) to split the scene into parts A and B.

4.5 Shot Planning​

Each scene breaks into visual moments with varying shot sizes (wide/master, medium, close-up, extreme close-up). Shots are numbered sequentially.

  • Character Appearance
    The system tracks physical appearance (faces, bodies, movement, emotions – no clothing) and outfits (colors, materials, style) separately to maintain consistency across shots.

  • Visual Consistency
    The system automatically maintains consistency: shots reference previous ones when needed, character appearances stay consistent, and related shots are tracked.

  • Multi-Location Scenes
    Shots alternate between locations (like film editing). Each shot shows only one location with characters appearing only in their designated space.

  • Shot Content
    Included: Environment, lighting, character actions/expressions, positioning, mood
    Not Included: Character clothing (handled by models), camera technical details, text/captions

4.6 Processing & Generation​

Once setup is complete, you are ready to generate.

  • File Limits: Maximum script size is 20 MB.
  • Concurrency: Up to 4 images process simultaneously. Run only one project at a time.

Modes​

  • Parallel: Faster generation.
  • Sequential: Better for strict visual continuity.

Troubleshooting & Common Issues​

IssueSolution
Characters Look DifferentUpload reference photos and ensure descriptions are full (5–7 sentences) including ethnicity and distinct features.
Generation StuckCheck internet connection and the Activity Panel. Do not run multiple projects at once. Refresh if necessary.
Images Not GeneratingCheck for content moderation triggers (especially with child characters). Ensure descriptions emphasize safe contexts.
Wrong Characters in SceneUse specific location names in your script headings. The system uses this to track who belongs where.
Shot Count MismatchThe system auto-adjusts totals to fit your budget; slight variations are normal.

✅ Quick Success Checklist​

Before Generation​

  • Script is in standard format with INT./EXT. headings.
  • File size is under 20 MB.
  • Descriptions (5–7 sentences) are written for all Characters, Locations, and Props.
  • Reference photos are uploaded for key characters.

During Generation​

  • Monitor the Activity Panel.
  • Review Scene Splits (e.g., Scene 1A/1B) to ensure logical break points.

After Generation​

  • Review visual consistency across shots.
  • Verify the flow of multi-location scenes.
  • Save and Export your storyboard.