---
name: nolgia-ugc-ads
description: "Produce vertical (9:16) UGC-style ad videos on NOLGIA: persona spec, consistent character portraits, app-screenshot B-roll, talking-head clips, TTS voiceover, and face-safe text overlay rules. Use for TikTok/Reels/Shorts ads, testimonial or influencer-style content, and scaling one character across many videos."
version: 1.0.0
author: NOLGIA
license: MIT
metadata:
  tags: [nolgia, ugc, ads, vertical-video, tiktok, reels, social]
---

# UGC Ads on NOLGIA

The pipeline that makes a UGC ad feel *edited* rather than *generated*:
persona → assets → talking head → interleaved timeline → safe-zone text.
Every step has a gate — don't advance past broken artifacts.

## 1. Persona first (one page, before any generation)

Identity (name/age/profession), visual spec (exact wardrobe wording —
you'll repeat it verbatim in every prompt), one specific pain-point
narrative, the app where they'd actually message, voice/energy, and 3–5
screenshot scenarios specific to THEIR story. Generic persona ⇒ generic
ad. Never reuse screenshots across characters — it kills authenticity.

## 2. Assets, in this order

```bash
# Portrait: head/shoulders in the UPPER 60% of frame (lower 40% = text space)
nolgia gen image --prompt "<persona visual spec>, selfie framing, golden hour" --out marcus.png

# Screenshots (3-5, each one narrative-specific)
nolgia gen image --prompt "phone messaging UI: unread 9pm quote request from a customer..." --out s1.png

# Voiceover
nolgia gen audio --prompt "<the 15s script>" --out vo.mp3
```

## 3. Talking-head base clip (15s, 9:16 — set it explicitly)

```bash
nolgia gen video --model fal-ai/kling-video/v3/pro/image-to-video \
  --input marcus.png --aspect-ratio 9:16 --duration-seconds 15 \
  --prompt "speaking to camera, natural mouth movement, small hand gestures, handheld selfie energy" \
  --out marcus_base.mp4
```

True audio-driven lip sync isn't on the platform yet — mux the voiceover
in post and hide desync with a cutaway-heavy edit (that's what step 4's
B-roll is for; a 1–1.5s insert every 2–3s means lips are rarely
scrutinized).

## 4. The timeline (what makes it an ad)

Interleave: 4–5 talking-head segments (1–4s, varied) + 3–4 screenshot
B-roll inserts (1–1.5s, slight push-in zoom, fade in/out) + the voiceover
driving problem → solution → CTA. A single 15s clip with text on top is
NOT a UGC ad.

## 5. Text overlay: face-safe zones (hard rule)

- **Top 16%** of frame: hook only ("I WAS LOSING $3K A MONTH")
- **Middle 68%**: the face — NEVER text
- **Bottom 16%**: captions/CTA ("NOLGIA.COM — SET UP IN 5 MIN")

Auto-fit text width to ≤92% of frame; shrink the font rather than
overflow; drop emoji (most display fonts render tofu); dark pill behind
white text for readability. Burn text in post — never ask the model to
render text.

## QA gates before shipping

1. Watch with sound OFF: does the story read from visuals + text alone?
2. Watch with sound ON: does any cut feel unmotivated? Add ambient/SFX.
3. Freeze random frames: text inside safe zones, face unobstructed?
4. Is the first 1.5s a hook (motion + claim), not a slow fade-in?
