--- title: "Generate a video from a first frame with Seedance 2.5, by asset id or by uploaded bytes" method: POST path: "/v2/video/generate/seedance-2-5-image-to-video" tags: ["video-generate"] --- # Generate a video from a first frame with Seedance 2.5, by asset id or by uploaded bytes `POST /v2/video/generate/seedance-2-5-image-to-video` Generate a video from a first-frame image and a text prompt with Seedance 2.5. Supply the first frame either as an `image_asset_identifier` reference (an image already stored with Ideogram) or as raw `image` bytes (multipart requests only) — callers are never required to upload the asset first. Exactly one source is required; supplying neither or both is rejected. Only image assets are accepted as a first frame. Uploaded bytes are used for this request only and are not stored as an asset. To generate a transition between two stills, supply a final frame as well, in either of the same two forms: `end_image_asset_identifier` or `end_image`. The final frame is optional and follows the same one-form-only rule. Seedance 2.5 always derives an image-to-video result's aspect ratio from its first frame, so this endpoint takes no `aspect_ratio`. Video generation always runs asynchronously: the response returns as soon as the request is accepted and carries only a `generation_id`. Poll for completion and results with `GET /v1/generations/{generation_id}` using that id, or supply a `webhook_url` to have the finished result POSTed to your server instead. Video links are available for a limited period of time; download the video if you want to keep it. ## Request body - GenerateVideoSeedDance25ImageToVideoRequest — Request body for Seedance 2.5 image-to-video generation. Supply the first frame either as an `image_asset_identifier` reference or (multipart requests only) as raw `image` bytes. Exactly one source is required. An optional final frame may be supplied the same way, with `end_image_asset_identifier` or `end_image`, to generate a transition between the two stills. - `image_asset_identifier` AssetIdentifier — An identifier for an ideogram asset. - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required - `asset_id` string, required - `image` string, binary — The first-frame image to animate (max size 50MB), as raw bytes; only common image formats such as JPEG, PNG, and WEBP are supported. Multipart requests only. The bytes are used for this request only and are not stored as an asset. - `end_image_asset_identifier` AssetIdentifier — An identifier for an ideogram asset. - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required - `asset_id` string, required - `end_image` string, binary — An optional final frame (max size 50MB), as raw bytes; only common image formats such as JPEG, PNG, and WEBP are supported. Multipart requests only. When supplied, the generated video transitions from the first frame to this one. The bytes are used for this request only and are not stored as an asset. - `prompt` string, required — A natural-language prompt describing how the first frame should animate. - `resolution` '480p' | '720p' | '1080p' — The resolution tier of the generated video. - `duration` integer — The length of the generated video in seconds. When omitted, the model picks the best duration for the prompt ("auto"). - `generate_audio` boolean — Whether to generate an audio track for the video. Audio roughly doubles the provider cost and is subject to stricter output moderation. - `webhook_url` string, 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. - `private` boolean, nullable — When true or omitted, the output is kept private to your account. Set to false to publish the output to the public feed. Enterprise accounts always generate privately. - `target_collection_id` string — A collection you can write to, by its URL-safe base64 collection id. The output video is added to it when the request completes. ## Response `200` An acknowledgement to poll with `GET /v1/generations/{generation_id}`. - GenerateVideoSeedDance25Response — Acknowledgement returned by the Seedance 2.5 video generation endpoints. Video generation always runs asynchronously, so the generated video is never part of this response: poll for it with `GET /v1/generations/{generation_id}` using the returned `generation_id`, or receive it at the `webhook_url` you supplied. - `generation_id` string, required — URL-safe base64 ID of the accepted generation. Accepted by the `GET /v1/generations/{generation_id}` polling endpoint. - `created` string, date-time, required — The time the request was accepted. ## Other responses - `400` — Invalid input provided. - `401` — Unauthorized. - `402` — Insufficient credits or quota. - `403` — This account does not have access to this model. - `404` — The referenced first-frame asset was not found. - `422` — The prompt did not pass safety checks. - `429` — Too many requests. - `500` — Internal server error. - `503` — The endpoint is temporarily unavailable. ## Changes - **2026-09-02** `1429d75daa36` — 2 info - added the media type `application/json` for the response with the status `402` - added the media type `application/json` for the response with the status `429` - **2026-08-31** `583d86789548` — 1 info - endpoint added [Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/v2/video/generate/seedance-2-5-image-to-video/post.md) --- [API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/revisions/5dc75f5e8df3?raw)