video-generate

Create a looping 360-degree product video

Animates one product image through a complete turntable revolution and returns to the starting pose so the result loops cleanly. Video generation runs asynchronously. Poll GET /v1/generations/{generation_id} with the returned generation_id until the generation completes or fails.

Authentication

Api-Keystring

API key for access control. Use in the header with the name “Api-Key”

Query parameters

dry_runbooleanOptionalDefaults to false
When true, the request is validated and priced but not run: nothing is generated, stored, or billed, and no safety review is performed. The response is a `PriceQuote` object instead of the usual response for this endpoint. Send exactly the request you would send to generate, so the quote reflects the same options.

Request

The product image and requested turntable motion.
image_asset_identifierobjectRequired
An identifier for an ideogram asset.
directionenumRequired
Direction the product rotates around its vertical axis.
Allowed values:
product_descriptionstringOptional<=200 characters
Optional factual description of the product in the source image.
resolutionenumOptionalDefaults to 720p
The resolution tier of the generated video.
Allowed values:
durationintegerOptional4-30

The length of the generated video in seconds. When omitted, the model picks the best duration for the prompt (“auto”).

Response

Product video accepted for asynchronous processing.
generation_idstring

URL-safe base64 ID of the accepted generation. Accepted by the GET /v1/generations/{generation_id} polling endpoint.

createddatetime
The time the request was accepted.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
503
Service Unavailable Error