Tools / UGC Video Turbo

Authentic UGC-style videos with real face references, native voice and ambient audio via Seedance 2.0 Omni-Reference (MuAPI). Drop in a persona headshot and get clips with consistent face, natural speech and room tone. For marketers and DTC brands who want real character consistency, not dubbed TTS.

Research Audience

Step 1: Research audience pain points, language, triggers, and objections. Async (1-3 min). Do NOT skip. Pass full output to generate_creative.

Returns: Structured audience research with pain points, problems, language patterns, emotional triggers, objections, and research summary

Write Hooks

Generate UGC video hooks using the 3-variable framework (Angle + Aesthetic + Action). Uses RAG from the UGC playbook. ⏱ ~5 seconds. Requires research output from step 1.

Returns: Array of hooks, each with text, angle, aesthetic, action, emotional trigger, and target pain point

Write Scripts

Generate authentic UGC scripts using But/Therefore zigzag structure. ⏱ 5-10s per hook. Requires hooks from write_hooks.

Returns: Array of scripts, each with hook_id, variation, hook_text, script_body, CTA, duration estimate, and mini-hooks at drop-off timestamps

Generate Scenes

Generate visual scene descriptions for each script, optimized for AI image/video generation. Set "format" for format-specific direction. Takes ~5s per script.

Returns: Array of scenes, each with scene description, setting, lighting, wardrobe, camera angle, mood, and shot list with visual changes

Generate Creative (Fast)

Generate hooks, scripts, and scene descriptions in one call (~8s). Set "format" for format-specific output. Photo formats return compositions instead of hooks/scripts. Pass FULL research output.

Returns: Video: hooks, scripts, scenes arrays. Photo: compositions + scenes.

Generate First Frames

Generate first-frame images from scenes. ~30s async. Pass existing_frames to skip frames that already have image_url. persona_image_url for face consistency.

Returns: Array of frames with image URLs and scene descriptions, plus asset paths for auto-upload

Generate Videos (Turbo)

Generate UGC video clips via MuAPI Seedance 2.0 Omni-Reference. Accepts real face photos as persona_image_url (no fal.ai face block). Takes 2-10 MINUTES. Seedance generates speech and ambient natively — voice is steered by persona.tone + persona.accent. Use check_video for pending clips.

Returns: Array of video clips with video URLs, script indices, segment indices, and duration. Long scripts auto-split across multiple clips with continuation keyframes.

Check Video Status

Check on a pending MuAPI video that was still generating when generate_videos returned. Pass the muapi_request_id. Returns the video URL if ready, or current status.

Returns: Video URL if completed, or current status (processing/failed) with instructions

Check Image Status

Check on a pending image that was still generating when generate_frames timed out. Pass the fal_request_id from pending_frames.

Returns: Image URL if completed, or current status with instructions

Regenerate Frame

Re-generate a single frame without re-running the full pipeline. Accepts optional revision notes for targeted edits.

Returns: Single frame object with image URL and scene description

Composite Product

Composite real product into frames. Inline chat images CANNOT be passed as URLs. Direct user to toolrouter.com/dashboard/files to upload their image.

Returns: Object with "frames" array (composited frames) — pass directly to generate_videos

Assemble Final Video

Stitch video clips into one final video with text overlays and transitions. Last step after generate_videos. Takes ~30-120s. Async.