Sign in

v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB
generate

Generate a video from an image with Seedance 2.0

Generates a video from a first-frame image and a text prompt using the Seedance 2.0 model. The request is always processed asynchronously: this endpoint returns immediately with a generation_id and an empty data array. Poll /v1/generations/{generation_id} with the returned generation_id to retrieve the video once it is ready, or supply webhook_url to have the result delivered to your server.

Supply the first frame in exactly one of two ways: upload the image bytes directly in the image part, or reference an existing Ideogram asset you own with image_asset_id. Provide exactly one of image or image_asset_id; supplying neither or both is rejected.

Video links are available for a limited period of time; if you would like to keep the video, you must download it.

post/v2/async/image-to-video/seed-dance-2.0

Query parameters

webhook_urlstring uri

HTTPS URL that Ideogram delivers the generated result to. Ideogram sends a JSON POST to this URL once all images for the request have finished generating. The body mirrors the synchronous generate response: request_id, created, and a data array containing every generated image (url, prompt, resolution, seed, is_image_safe). Each delivery is signed with Ed25519 and verifiable against the public keys at https://api.ideogram.ai/v1/.well-known/jwks.json. Must be HTTPS; private and loopback hosts and the cloud metadata service are rejected.

Example:https://api.example.com/webhooks/ideogram

Response

Request accepted; poll or await the webhook for the result.

generation_idstring required

URL-safe base64 ID of the accepted generation. Poll /v1/generations/{generation_id} with this id to retrieve the result.

createdstring date-time required

The time the request was created.

Example response

{
  "data": [
    {
      "duration": 5,
      "aspect_ratio": 969,
      "object_type": "video.generation",
      "prompt": "prompt",
      "resolution": "720p",
      "url": "https://ideogram.ai/assets/video/lossless/response/xtdZiqPwRxqY1Y7NExFmzB.mp4?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
    },
    {
      "duration": 5,
      "aspect_ratio": 969,
      "object_type": "video.generation",
      "prompt": "prompt",
      "resolution": "720p",
      "url": "https://ideogram.ai/assets/video/lossless/response/xtdZiqPwRxqY1Y7NExFmzB.mp4?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
    }
  ],
  "generation_id": "generation_id",
  "created": "2000-01-23T04:56:07+00:00"
}