/ai-ugc-video

name: "ai-ugc-video"
description: "Make realistic AI UGC videos cheaply: viral research, locked assets, scripts, Seedance/Avatar IV generation, and final edit. Use for AI UGC ads, talking-head videos, or AIGC short films."

AI UGC video production

Six stages, run in order. Each stage ends with the user approving something; nothing moves to a more expensive stage until the cheap one passes.

**First, work out which stage we're in** and say so in one line. If the user brings assets (a repo, a folder, an earlier video, a reference post), read them before asking anything: never ask for what is already there, and never regenerate what exists.

| Stage | Run it when | | --- | --- | | 1 Research | No reference post decoded yet, or the user names a niche or reference accounts | | 2 Assets | Reference decoded, but no locked characters, wardrobe, locations or product | | 3 Voices | Characters locked, no approved voice references | | 4 Shoot plan | Assets and voices ready, no approved shoot plan | | 5 Video | Shoot plan approved | | 6 Finish | Clips approved; dubbing, captions, assembly |

Rules for every stage

**Cost.** Four tiers, each about 10x the one before: text (fractions of a cent) → stills (~$0.03) → 480p drafts (~$0.12/s) → final (720p ~$0.27/s, 1080p ~$0.46/s). Settle every decision at the cheapest tier that can settle it. Quote the cost before any paid call and wait for a go-ahead. Budget 3 generations per usable shot and say so up front. Video is refused on free treg credit; check the paid balance first. A refused or failed job is not charged; a finished take that misses is.

**One document: the shoot plan.** Everything the model receives lives in one plan (stage 4). Opinions, history, risks and costs of past drafts go in a separate production log, never in the plan. A sentence the model will not read does not belong in the plan.

**Realism.** Camera description goes first in every prompt. Every reference gets an explicit job: what it controls and what it must not supply. Name devices, Kelvin values and visible light sources; never write "cinematic", "8K", "masterpiece" or "professional lighting". Ask for flaws: handheld tremor, focus hunting, sensor noise, uneven exposure, visible pores. Paste locked descriptions word for word; anything rewritten from memory drifts between shots.

**Ethics.** Remix the structure of a viral post, never the people in it. No real creator's face, voice or footage goes into a generation; no celebrity-imitation voices.

**You cannot hear.** Say so. Judge video from a timestamped 2 fps frame contact sheet and list what frames cannot show (bounce, lip sync, voice, pronunciation). Hand every audio check to the user before spending on the next tier.

Tools (all via treg; `catalog_get` for live prices)

| Job | Endpoint | Notes | | --- | --- | --- | | Reference post stats, transcript, video file | `scrapecreators.tiktok.video.detail` | ~$0.002; download the video from `play_addr` for frame grabs | | Trending posts, comments | `tikhub.tiktok.search.videos`, `tikhub.tiktok.video.comments` | only when the user has no reference | | Stills | `reapi.image-gen.gemini-3-pro-image` | 2K, up to 14 reference images | | Voice clone + TTS | `fishaudio.voices.create` (free; multipart `voices` upload) then `fishaudio.tts.s2-1-pro` with `reference_id` | fractions of a cent per line | | Video with sound from stills | `reapi.video-gen.seedance-2-5.unrestricted` | `image_with_roles` (first_frame + reference_image) + `audio_urls`; no video input | | Video from a video (remake/edit) | `piapi.video-gen.seedance-2-5.less-restriction` | `video_urls` + `audio_urls`; duration in 5 s steps; billed input + output (~1.4x reAPI) | | Lip sync from a still | `openrouter.x.heygen-avatar-iv` | $0.05/s; locked camera | | Silent video | `minimax.video-gen.from_image` (Hailuo 2.3) | no 480p; draft at 768P |

Seedance input rules: every reference image between 0.4:1 and 2.5:1 (pad wide cast sheets); every audio file 2–30 s; PiAPI allows 15 s of audio references in total; hosted files must return raw bytes (a GitHub raw URL works); first_frame requires `size: adaptive`.

---

Stage 1 · Research and decode

If the user brings one reference post, decode it and skip the trend pull: fetch stats and transcript, download the video, grab frames at 2 fps, and write:

• `[HOOK]` first 3 s: what is on screen, words if any
• `[BEATS]` one line per beat: time range → one action (this is the structure we copy)
• `[CAMERA]` selfie / handheld / tripod / walking / phone or camera, lens feel, focus behaviour
• `[LIGHT]` source, direction, quality, time of day
• `[AUDIO]` talking, music, ambience; who speaks
• `[LENGTH]` and aspect ratio
• `[REPRODUCIBLE?]` what we rebuild, what we drop (real faces, real places, real footage)

If the user has no reference: pull ~30 trending posts in the niche from the last 30–60 days, show the 15 strongest (link · date · views · first 3 s · hook type · length), decode the user's 3–5 picks as above, add `[WHY IT WORKS]` from the comments, and check each pattern repeats across 3+ accounts.

Stage 2 · Assets

Lock characters, wardrobe, locations and product on image credits.

If the user has a repo of cast sheets and plates, map them to the roles in the decoded reference and confirm the mapping in one table (reference person → cast file → role). Do not regenerate what exists. Pad cast sheets wider than 2.5:1 before they go into video calls.

For new assets, one question at a time, and for every uploaded reference ask what it controls (identity, outfit, space, product shape, or only camera, light and texture):

**Face portraits.** CTLT prompt, camera first: `Camera:` device, lens, framing, height, horizon, "candid, unposed". `Tone:` who, doing what, where. `Lighting:` quality, direction, Kelvin, motivated by a visible source; one dominant source; ordinary UGC light. `Texture:` visible pores, fine freckles, creases at the eye corners, slight asymmetry, T-zone sheen, un