---
tier: hero
reliability: 4.0 # the exact-number layer is deterministic (PIL/hyperframes) so numbers are always right; SenseNova design pass is the variable .0; Sonilo licensed audio verified
---

# Insight Reel — data that explains itself, with exact numbers ⭐

> Paste this whole file (with the BRIEF filled in) into Claude cowork, chat, or Code with the Storyboard MCP attached. Drop in your numbers; get back a premium vertical reel where the KPIs animate, a chart draws in, and a licensed bed plays — with **every figure guaranteed exact**. The B2B reel pure-generative tools physically can't make.

## What you'll get

- A **premium data infographic reel** (9:16) — headline, labeled KPI blocks, a revenue-trend chart, a licensed music bed.
- **Numbers that are correct.** The figures are placed by a deterministic layer, not hallucinated by an image model.
- (Optional) **SenseNova U1 design pass** — an AI that *reasons about your data* to propose the layout/story.

**Reference run (our showcase):** ≈$2 · ≈10 min end-to-end · SenseNova U1 design pass ~4 min, Sonilo bed 90s, figures placed deterministically. See the [example](/chapters/insight-reel-example.html).

## The hard truth this playbook is built around

AI infographic models make beautiful layouts and **get the numbers wrong.** In testing, `sensenova-u1-infographic` produced a gorgeous board but labeled Net Revenue Retention as "1,840" (the customer count) and garbled several labels. **So the design and the numbers are split:**

- **Design / story** → `sensenova-u1-infographic` (it reasons about the data and proposes a premium layout) — use it for inspiration + the "AI understood the data" hero, but **never trust its text**.
- **Exact numbers** → a **deterministic render** (hyperframes-render with your real values, or a local PIL/HTML render as the fallback). This guarantees every figure + label is correct and legible.

This split is the whole point — premium look *and* trustworthy numbers.

## Tell the agent about the data

```yaml
title:            # e.g. "Q4 FY25 — Record Quarter"
eyebrow:          # e.g. "Investor Update"
kpis:             # 3-6 metrics, each: label + exact value (+ optional delta)
  - { label: "Revenue", value: "$4.2M", delta: "+38% YoY", hero: true }
  - { label: "Net Revenue Retention", value: "119%" }
  - { label: "Active Customers", value: "1,840" }
  - { label: "Gross Margin", value: "81%" }
  - { label: "Cash Runway", value: "31 mo" }
trend:            # OPTIONAL bar chart, e.g. [["Q1",38],["Q2",52],["Q3",71],["Q4",100]]
palette:          # brand colors; default premium dark-navy + gold + teal
music_brief:      # mood for the licensed bed, e.g. "confident corporate, warm piano, uplifting"
launch_slug:      # e.g. q4-fy25-insight
```

## How the agent should run this (interaction contract)

1. **CONFIRM (1 message).** Read back the KPIs verbatim ("these exact figures will appear — confirm them") + the palette/music. The numbers are the product; lock them.
2. **(Optional) DESIGN PASS.** `sensenova-u1-infographic` for a layout proposal — show it, but flag "design only; numbers below come from your exact values." Heavy cap (~5 min) → direct-SDK with `timeout: 600` (or `create_media` once the slow-cap fix is deployed).
3. **EXACT RENDER.** Build the infographic with the **real values** — `hyperframes-render` (animated count-ups + chart, pixel-perfect) over atmospheric b-roll; fall back to a local PIL/HTML render if hyperframes is unavailable. **Every number from the BRIEF, verbatim.**
4. **SCORE (Licensed Sound skill).** `sonilo-t2m` bed from `music_brief` (commercial licensing); mux looped + faded.
5. **VERIFY + DELIVER.** Render-and-look: every KPI matches the BRIEF exactly; bed sits under, fades out. One honest line + the file.

## What can disappoint (cap ceilings)

- **SenseNova numbers are unreliable** — by design we don't use its text, only its layout sense. Don't paste its figures.
- **hyperframes payment/availability** — if the cap is down, the local PIL/HTML render is the deterministic fallback (same guarantee).
- **AI b-roll** behind the data is atmospheric only; keep it dark/low-contrast so the numbers read.

## When you're done

```
✅ Insight reel: public/launches/{launch_slug}-reel.html
✅ Reel MP4 (9:16) with licensed bed · every figure exact
Total spent: $X.XX
```

## What to do next
1. **Drop it in the investor update / earnings post** — vertical, captioned, numbers correct.
2. **Re-run next quarter** — same template, swap the KPIs; the design holds.
3. **Pair with a talking-head intro** (see talking-avatar) for a founder-narrated version.

---

## Notes for the agent (only read if a step fails)

**SenseNova timeout.** Heavy cap (~5 min). If `create_media` reaps it, use direct-SDK: `POST /inference` `{"capability":"sensenova-u1-infographic","params":{"prompt":"<design brief>"},"timeout":600}`. See `docs/infra/2026-06-19-slow-cap-timeout-fix.md`.

**Exact-number layer.** Prefer `hyperframes-render` (html + background_video_url) with the BRIEF's values hard-coded in the HTML (count-up via JS, bars via CSS height). If hyperframes is unavailable, render the same layout locally with PIL → a still → ffmpeg Ken-Burns (this box has no ffmpeg `drawtext`/libfreetype, so PIL is the text renderer). NEVER source numbers from an AI image model.

**Audio.** `sonilo-t2m` returns `.m4a` (AAC) — match that extension when downloading; mux with `audio_fill:"loop"` + `afade` out.