Sign in
UGC

Create a UGC hook video

Builds a finished UGC-style hook video: a person reaction clip with your hook text on top, optionally followed by your product demo video.

Inputs:

  • reactionId: a clip from GET /ugc/reactions (built-in or one you generated).
  • hookText: the on-screen hook (5-200 characters).
  • demoVideoAssetId (optional): a product demo video uploaded with POST /uploads (purpose ugc-demo).

Returns a videoId. This one is ready immediately (status: completed); export it with POST /exports and download with GET /exports/download, or publish it.

Cost: flat fee (see creditsUsed). Requires an active paid subscription.

post/ugc/videos

Request body

hookTextstring required

The on-screen hook text (5-200 characters).

reactionIdstring uuid

A reaction clip from GET /ugc/reactions.

ugcVideoIdstring uuid

Dashboard alias for reactionId. Public callers use reactionId.

demoVideoAssetIdstring uuid

Optional product demo video, uploaded via POST /uploads (purpose ugc-demo). Plays after the reaction.

demoVideoUrlstring uri

Dashboard use only. Public callers pass demoVideoAssetId instead.

demoDurationSecondsnumber

Dashboard use only. Required when demoVideoUrl is set.

demoVideoWidthinteger

Dashboard use only.

demoVideoHeightinteger

Dashboard use only.

hookTextPosition'top' | 'center' | 'bottom'

Where the hook text sits.

aspectRatio'9:16' | '16:9' | '1:1'

Video dimensions.

backgroundMusicIdstring uuid

Dashboard use only. Background music track ID.

backgroundMusicVolumenumber

Dashboard use only. Background music volume (0-100).

captionStyleIdstring

Caption style ID from GET /caption-styles. Default: "tiktok".

titlestring

Optional video title.

Response

OK

videoIdstring uuid required

The finished video. Export with POST /exports, download with GET /exports/download.

status'completed' required
creditsUsednumber required
durationSecondsnumber required

Changes

Changed in 1 of the 7 revisions of this API.12

  • ac1de8fd0dfc12See the full diff
    • ▲

      the oneOf[subschema #1]/data response's property type/format changed from / to object/ for status 403

      response-property-type-changed

    • ○

      the response property oneOf[subschema #1]/data became required for the status 403

      response-property-became-required

    • ○

      added the required property oneOf[subschema #1]/data/feature to the response with the 403 status

      response-required-property-added