Script Analysis
Script analysis is the first phase of the B-Roll pipeline. AI reads your video script and identifies moments where B-Roll footage would enhance the visual storytelling.
How to Analyze
- 1Paste your video script into the script editor on the project page.
- 2Choose a density using the pill buttons above the Analyze button — this controls how many B-Roll moments the AI identifies. See Density for details.
- 3If you're using Credits, a cost preview appears showing the estimated credit cost before you confirm. See Credits for how billing works.
- 4Click Analyze. The AI reads your script and returns moments and suggestions.
Density Selector
The density selector (pill buttons above Analyze) controls how many B-Roll moments the AI identifies in your script:
~1 moment per 400 words (min 2). Focuses on the most impactful B-Roll opportunities.
~1 moment per 200 words (min 3). Balanced coverage — the default setting.
~1 moment per 100 words (min 3). Covers nearly every visual opportunity in the script.
No cap — the AI uses its full editorial judgment to decide how many moments the script needs.
See Density for a full explanation of each option and when to use them.
Credits vs. BYOK: Analysis works identically in both modes. The only difference is how AI calls are billed — Credits users are charged from their balance, while BYOK users are billed directly by their API provider. Credits users see a cost preview before each analysis. See Credits for details.
How It Works
When you click Analyze, your script text is sent to the AI model you've configured. The AI identifies:
- MMoments — Specific sections of your script where B-Roll footage would enhance the video. Each moment includes the relevant script excerpt, a timestamp hint, and an editorial note explaining why B-Roll is needed.
- SSuggestions — For each moment, the AI generates one or more suggestions for what B-Roll to look for. Each suggestion includes a type (visual, spoken, or event), a description of the ideal footage, specific YouTube search queries, and a recommended duration.
Suggestion Types
Each suggestion is categorized by type, which helps you understand what kind of footage to expect:
Footage that visually illustrates what the script is discussing. Example: cityscape footage when talking about urban development.
Video where someone is discussing the topic, often from news reports, interviews, or presentations.
Footage of a specific event mentioned in the script, like a product launch, conference, or natural event.
Tips for Better Results
- Use a complete script with clear topic descriptions — the more context, the better the suggestions.
- Include section markers or timestamps in your script if you have them.
- Use the density selector to control how many moments the AI identifies. Start with Standard and adjust based on your script length and editing style. See Density for guidance.
- For faster, cheaper analysis, use a model like GPT Mini or Gemini Flash. You can always use a more powerful model for evaluation later.
Re-Analyzing
You can click Analyze again at any time to re-analyze your script. This replaces all existing moments with fresh results. Search results and evaluations from the previous analysis will be cleared.