Sign in
video-generate

Turn a still image into a subtle looping video

Changed on

Animates one image into a short, loop-ready clip for use as a living background. The camera stays fixed and only the parts of the scene that would move in real life move: water, light, mist, particles, fabric, creatures. Ideogram inspects the image and writes the motion prompt, so the request needs only the image. Video generation runs asynchronously. Poll GET /v1/generations/{generation_id} with the returned generation_id until the generation completes or fails.

post/v2/tool/living-image

Request

  • Base URL: (relative, and it does not resolve against the document’s source URL)
  • URL: /v2/tool/living-image
  • Auth: one of:
    • API key in header Api-Key
    • HTTP bearer

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

quality'standard' | 'high'

The output resolution tier. standard renders at 768P; high renders at 2K. Higher tiers cost more.

durationinteger

The length of the generated video in seconds.

target_collection_idstring

A collection you can write to, by its URL-safe base64 collection id. The output video is added to it when the request completes.

Example request

{
  "duration": 8,
  "target_collection_id": "target_collection_id",
  "image_asset_identifier": {
    "asset_type": "RESPONSE",
    "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
  },
  "quality": null
}

Response

Living image 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.

Example response

{
  "generation_id": "generation_id",
  "created": "2000-01-23T04:56:07+00:00"
}

Changes