Make a UGC video
Make one vertical, creator-led UGC video. Resolves an approved catalog or saved presenter, creates one durable UGC video job, and returns immediately. Poll GET /v1/jobs/; the same idempotency key recovers a lost acknowledgement without starting a second render. Quote first with X-Sigmora-Quote-Only, then cap the real call with X-Sigmora-Max-Credits.
Authorizations
A workspace API key.
Headers
Required durable retry key. Reuse only for the identical logical request; a different payload returns conflict.
1 - 255Send 1 to get the price and balance without running anything.
"1"The approved price; a call that would cost more is refused and nothing is charged.
^\d+$Body
Vertical UGC format: talking-head or product-in-hands.
talking-head, product-in-hands Stable presenter reference: catalog:: or saved:.
1 - 200Public HTTPS image URL or Content Engine content id; media bytes never go through MCP.
1 - 2000Approved spoken script for the single-take render.
8 - 600Explicit confirmation that the caller has rights to use the product image.
Explicit confirmation that the presenter likeness is approved for this render.
Explicit confirmation that product claims in the script are accurate and approved.
Existing project that owns the generated UGC video.
1 - 200Use generate for a new script-led take, talking-avatar to animate the presenter photo speaking the script (talking-head only), or source-performance to transfer a declared source video performance onto the approved presenter. A saved real person needs a verified likeness consent in every mode.
generate, source-performance, talking-avatar Opt in to burned captions in the delivered video; defaults to false.
For source-performance, choose this direct public HTTPS source-video URL or Content Engine content id, or sourceAssetId; media bytes never go through MCP.
1 - 2000For source-performance, a ready visual-video Asset in this workspace Library. Use this instead of sourceVideo when the source is already in Sigmora.
1 - 200Required only for source-performance: the requester-declared authority for the source video (owned, licensed, or permission).
owned, licensed, permission Optional, source-performance only: copy just this part of the source video (3-30 seconds). Omit to let Sigmora pick from the whole video.
Required only for source-performance: requester attests they have the source performer’s authorization. This is not independently verified by Sigmora.
Required only for source-performance: requester attests they have authority from the source video’s rightsholder. This is not independently verified by Sigmora.
Response
Success.
"video.render""ugc""rendering"-9007199254740991 <= x <= 9007199254740991