A UGC Ad Generator API You Can Call From Your Own Stack

Models that fit

UGC ads render on a reference-to-video model from this catalog, picked for you — the UGC ad endpoint takes no model field.

Try it

This request uses the UGC ad endpoint and the public UgcAdRequest schema. Replace YOUR_UPLOAD_ID with the id POST /api/v1/uploads returns for your product photo.

curl -X POST "https://reviral.ai/api/v1/ugc-ad" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Idempotency-Key: first-generation" \
  -H "Content-Type: application/json" \
  --data '{"uploadId":"YOUR_UPLOAD_ID","angle":"unboxing","creator":"lifestyle","scene":"kitchen","prompt":"A creator-style unboxing and honest review of a stainless steel water bottle, casual and upbeat","durationSec":15,"resolution":"720p","aspectRatio":"9:16"}'

Frequently asked questions

What input does the UGC ad API need?

A product photo, uploaded first with POST /api/v1/uploads — its uploadId goes in the request — plus a prompt describing the product, and an angle, a creator and a scene. GET /api/v1/ugc-ad/options lists the allowed values. Send an Idempotency-Key header so a retried request is never charged twice.

How is it priced?

Credits are charged per ad based on its length and resolution (15 seconds at 720p by default). Call POST /api/v1/calculate-credits with kind: "ugc-ad" and your API key to see the exact price first, or pass maxCredits so a price change fails the request instead of charging more.

Can I choose which video model renders the ad?

No — the UGC ad endpoint picks the reference-to-video model for you, so the product in your photo stays on screen. To call one specific model directly, use POST /api/v1/generate-media.