UnrealUGC

Get started

Quickstart

Generate your first AI UGC video ad in under 5 minutes.

1. Create an API key

Sign in at unrealugc.com and head to Settings → API Keys. Click Create key, give it a name, and copy the usk_live_… token — we only show it once.

Set it as an environment variable so the snippets below just work:

bash
export UNREALUGC_API_KEY="usk_live_..."

2. Make your first request

Confirm the key works by hitting the account endpoint:

bash
curl https://unrealugc.com/api/v1/me \
  -H "Authorization: Bearer $UNREALUGC_API_KEY"

You should see your plan, subscription status, and credit balance.

3. Generate a video

Pick a stock creator and kick off a generation. The endpoint returns immediately — the video starts in GENERATING and finishes in 2-5 minutes.

bash
curl https://unrealugc.com/api/v1/videos \
  -X POST \
  -H "Authorization: Bearer $UNREALUGC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "creatorId": "tech-savvy-female-30",
    "script": "Two weeks in and I genuinely cannot believe how much this changed my routine.",
    "productName": "Acme Skincare",
    "videoModel": "kling-2.6",
    "useNativeAudio": true,
    "aspectRatio": "9:16"
  }'

Browse all params or call GET /v1/creators to see every stock creator id.

4. Get the result

Two ways:

  • Poll GET /v1/videos/:id every ~15 seconds until status: "COMPLETED".
  • Webhooks (recommended) — register an endpoint and receive a signed POST the moment the video is ready. See Webhooks.
bash
curl https://unrealugc.com/api/v1/videos/$VIDEO_ID \
  -H "Authorization: Bearer $UNREALUGC_API_KEY"

When done, the response includes outputUrl— that's your final, ready-to-use MP4.

What's next

PreviousOverviewNext API reference