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

Models that fit

The ugc-ad workflow renders on video models from this catalog — set premiumVideoModelId to pin a specific one, or let the workflow choose for your tier.

Try it

This request uses the render endpoint's workflow field, validated against the public RenderRequest schema.

curl -X POST "https://reviral.ai/api/v1/render" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"workflow":"ugc-ad","prompt":"A 30-second creator-style unboxing and review for a stainless steel water bottle, casual and upbeat","durationSec":30,"aspectRatio":"9:16","productUrl":"https://example.com/products/steel-bottle"}'

Frequently asked questions

What input does the UGC ad workflow need?

At minimum workflow: "ugc-ad" and a prompt describing the product and angle. productUrl links a product page or photo, and avatarImageUrl is optional if you want a specific creator likeness — see the render endpoint reference for the complete field list.

How is it priced?

Like every render workflow, credits are charged per completed job based on the tier and duration you request. Call POST /api/v1/calculate-credits first to estimate the cost without authentication or a debit.

Can I choose which underlying video model renders the ad?

Optionally — set premiumVideoModelId to pin a specific model from the catalog. Otherwise the workflow selects one automatically for the tier you chose.