video-generate

Create a looping 360-degree product video

Changed on

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.

post/v2/tool/product-360-video

Request

  • Base URL: https://api.ideogram.ai
  • URL: https://api.ideogram.ai/v2/tool/product-360-video
  • Auth: API key in header Api-Key

Query parameters

dry_runboolean

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 body

direction'clockwise' | 'counter-clockwise' required

Direction the product rotates around its vertical axis.

product_descriptionstring

Optional factual description of the product in the source image.

resolution'480p' | '720p' | '1080p'

The resolution tier of the generated video.

durationinteger

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 required

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

createdstring date-time required

The time the request was accepted.

Changes