Form · one brief in, one finished spot out
UGC product videoPOST /v1/forms/ugc-product-video
A creator-style spot from a brief instead of a prompt. Send the product name and one to five selling points; the service compiles them into a shot — handheld phone framing, natural light, platform-native aspect and pacing, the selling points spoken as beats rather than read as a list — and renders it. You get back the compiled prompt with the job, so the shot is inspectable and reusable.
- product_name*
- what is being sold, written the way the speaker would say it out loud.
- selling_points*
- one claim per entry, in plain speech. They become spoken beats in the order you send them — the compiler weaves them into a continuous line of dialogue, it does not read them out as a list.
- platform
- decides aspect ratio and pacing: tiktok 9:16, reels 9:16, shorts 9:16, landscape 16:9. Default: tiktok.
- tone
- how the speaker delivers it, which changes the performance direction in the compiled prompt. Default: casual.
- duration_s
- seconds of finished video, and the beats are timed to it. 4-12 on the default renderer (seedance-1.5-pro); name another in `model` for its range — seedance-1.5-pro 4-12s; seedance-2.0 4-15s; seedance-2.0-mini 4-15s; seedance-2.5 4-30s. Default: 5.
- image_urls
- one publicly fetchable https photo of the product, used as the opening frame: the take opens on the product exactly as photographed, then the phone pulls back and the speaker brings it up, already talking. Only the first frame is pinned. Taken on seedance-1.5-pro only — with another `model` it is a 400 before any charge — and fetched once after payment verifies: a URL that does not answer 200 with a JPEG, PNG or WebP is a 400 with nothing charged. Default: none.
- model
- which catalog model renders the compiled prompt, and therefore what the clip costs and how long it may run — see `per_model` on duration_s. The default is the only one that carries its own spoken audio, which a talking-head spot needs. Default: seedance-1.5-pro.
$0.372 for the worked example — 5s 9:16 rendered by seedance-1.5-pro. The chosen renderer's own rate for the same clip, plus $0.06 to compile the brief. * required.