Step-by-Step Clip Workflow
- Lead captured — via /free-clip form → stored in
free_clip_leads
- Queue clip — POST /admin/queue-leads creates a record in
clips with status pending
- Opus Clip extraction — if API key set, calls Opus Clip API to auto-extract best moment. Falls back to
awaiting_manual if unavailable.
- Caption styling — FFmpeg applies template styling (bold_white / bold_yellow / branded) with background overlay and text animation
- Format export — Converted to 9:16 TikTok, 9:16 Shorts, and 1:1 Reels via FFmpeg
- Upload to R2 — Video + thumbnail uploaded to Polsia R2; clip_url stored in DB
- AI scoring — OpenAI scores engagement potential 0-100 based on caption hooks and format
- Deliver — Status =
completed. Email delivery to client (future feature)
Templates: real_estate · gym · restaurant
Output formats: 9:16_tiktok · 9:16_short · 1:1_reels
Caption styles: bold_white · bold_yellow · branded