An Image to Video API for Avatar and Product-Image Workflows

Models that fit

Every video model in the catalog can serve as the renderer on avatar-to-video, and UGC ads use a reference-to-video model — neither takes a raw image parameter on generate-media.

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":"avatar-to-video","prompt":"A friendly, energetic 30-second product walkthrough delivered straight to camera","durationSec":30,"aspectRatio":"9:16","avatarImageUrl":"https://example.com/avatars/creator-01.jpg"}'

Frequently asked questions

Can I animate any photo into a video?

Not yet on the public API — generate-media's v1 schema is prompt-only with no image field. The closest supported paths are the avatar-to-video workflow on POST /api/v1/render (avatarImageUrl) and POST /api/v1/ugc-ad (the uploadId of a product photo from POST /api/v1/uploads), which take a specific image role rather than an arbitrary photo.

What does avatarImageUrl do?

It supplies the likeness the avatar-to-video workflow animates — combine it with a prompt describing the delivery and script.

How do I turn a product photo into an ad?

Upload the photo with POST /api/v1/uploads, then send its uploadId to POST /api/v1/ugc-ad with a prompt, an angle, a creator and a scene — see the UGC ad API use case for the full request.