Make Images, Videos, Voice and UGC Ads

Every field for making images, videos, voice overs and UGC ads through the API, and how to see the cost first.

Open the tool

This page lists each kind of job you can start with the Public API and every field it takes.

What it does

A job is one piece of work. You send a request, and the answer comes straight back with a job id while the work runs. Results come later: read the job, or use a webhook.

Every call that makes something needs an Idempotency-Key header. If your network drops and you send the same request with the same key, you get the first answer again and pay once. Use any 8 to 80 letters, digits, hyphens or underscores. A key can be used again after 24 hours.

Step by step

Ask the price with POST /quote. It is free and holds nothing.
Start the job with its own call.

Every option explained

Ask the price first

POST /api/public/v1/quote takes type (image, video, voice or ugc) and the fields of that job.

Images

POST /api/public/v1/images

Field	Meaning
`prompt`	What to make, up to 2,000 characters
`ratio`	`1:1`, `4:5`, `3:2`, `16:9` or `9:16`
`count`	How many, 1 to 4
`tier`	`auto`, `flash`, `studio` or `pro`. Auto picks for you.
`references`	Up to 3 asset ids, for look or layout
`people`	Up to 4 asset ids of a person to keep the same
`products`	Up to 4 asset ids of a product to keep the same

A picture in the request moves the job to a tier that can read pictures, so the quote tells you the real price.

Videos

POST /api/public/v1/videos

Field	Meaning
`prompt`	What happens in the video
`ratio`	`9:16`, `16:9`, `1:1` or `auto`. With a `start_frame` or `end_frame` and no ratio, `auto` is used: the video takes the frame's shape, the nearest one the tier makes
`seconds`	The length. A tier makes only certain lengths, and the nearest one is used.
`tier`	`auto`, `motion` or `cinema`
`start_frame`	An asset id for the first frame
`end_frame`	An asset id for the last frame

Voice overs

POST /api/public/v1/voice

Field	Meaning
`text`	What to say
`voice`	A voice id from `GET /voices`. Leave it out for your default voice.
`language`	A language code such as `hi` or `en`, or `auto`
`level`	`standard` or `studio`

GET /api/public/v1/voices lists voices. Add ?lang=hi to see Hindi voices.

A finished voice job has files, with an address for each format.

UGC ads

POST /api/public/v1/ugc

Field	Meaning
`product`	The asset id of a clear photo of the product. Required.
`prompt`	Anything you want added, in your own words
`mode`	`image` or `video`
`takes`	For images, how many different takes, 1 to 3. Each is its own job, with its own charge. If credits run out, fewer jobs are made and `jobs` shows them.
`category`	A product category code such as `SKIN` or `FOOD`

Using your own pictures

Upload a picture first and use its asset id in the fields above. See Jobs and assets.

Common problems

I get content_blocked

The same safety rules as the website apply. Nothing is charged. Change the request.

My picture came out different from the product

Send the product in products, with a clear, well lit photo.

I get spend_cap_reached

This job would pass the cap on this key. The answer says which cap and how much is used. Raise it in the API tab, or wait for the next day or month.

Related guides

Updated 4 Nov 2026