Sign in

v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB
generate

Generate a video from text with Seedance 2.0

Generates a video from 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.

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/text-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

Request body

promptstring required

A natural-language prompt describing the video to generate.

aspect_ratio'AUTO' | '21x9' | '16x9' | '4x3' | '1x1' | '3x4' | '9x16'

The aspect ratio of the generated video. AUTO lets the model choose the most suitable ratio from the prompt; any other value pins the ratio.

resolution'480p' | '720p'

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").

num_videosinteger

How many videos to generate for this request. Each video is generated and billed independently.

generate_audioboolean

Whether to generate an audio track for the video. Audio roughly doubles the provider cost and is subject to stricter output moderation.

Example request

{
  "duration": 5,
  "aspect_ratio": null,
  "num_videos": 1,
  "generate_audio": false,
  "prompt": "A red fox running through a snowy forest at dawn.",
  "resolution": null
}

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"
}