seedance_generate_video_from_image
Generate AI videos from images by specifying first frame, last frame, or reference images for style and content guidance. Create transitions and motion.
Instructions
Generate AI video using reference images with ByteDance Seedance.
This allows you to control the video by specifying first frame, last frame,
or reference images. Seedance will generate smooth motion based on the inputs.
Use this when:
- You have a specific image you want to animate
- You want to create a video transition between two images
- You need style guidance from reference images
- You need precise control over the video's visual content
Note: reference_image_urls cannot be combined with first_frame_url/last_frame_url.
At least one image input must be provided.
Returns:
Task ID and generated video information including URLs and metadata.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Random seed. -1 for random. Default is -1. | |
| model | No | Model version to use. Use 'doubao-seedance-2-0-260128' (default) for latest-generation quality and multimodal reference, 'doubao-seedance-2-0-fast-260128' or 'doubao-seedance-2-0-mini-260615' for faster/cheaper 2.0, or a 1.x model such as 'doubao-seedance-1-0-lite-i2v-250428' for lightweight I2V. | doubao-seedance-2-0-260128 |
| ratio | No | Video aspect ratio. Use 'adaptive' to match your input image ratio. | 16:9 |
| frames | No | Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 361). Mutually exclusive with 'duration'. | |
| prompt | Yes | Description of the video motion and content. Describe what should happen in the video, how objects should move, what transitions to include. | |
| duration | No | Video duration in seconds. Range: 2-15 (Seedance 2.0 supports 4-15). Default is 5. Mutually exclusive with 'frames'. | |
| resolution | No | Video resolution. Options: '480p', '720p', '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-0-fast' and '2-0-mini' max out at '720p'. | 720p |
| callback_url | No | Webhook callback URL for asynchronous notifications. | |
| service_tier | No | Service tier. 'default' or 'flex' (50%% cheaper). Default is 'default'. | default |
| generate_audio | No | If true, generate audio. Supported by 'doubao-seedance-1-5-pro-251215' and the 'doubao-seedance-2-0' series. Default is false. | |
| last_frame_url | No | URL of the image to use as the last frame of the video. The video will animate towards this image. Supports https:// URLs or base64 data:image/... URIs. | |
| first_frame_url | No | URL of the image to use as the first frame of the video. The video will animate from this image. Supports https:// URLs or base64 data:image/... URIs. | |
| return_last_frame | No | If true, return the last frame of the generated video. Default is false. | |
| reference_audio_urls | No | Seedance 2.0 only. Reference audio URLs (up to 3) for voice timbre / background music. Ignored by 1.x models. | |
| reference_image_urls | No | List of reference image URLs for style/content guidance. For the Seedance 2.0 series these can be real-person / character references that keep the subject consistent (up to 9). These images influence the look but are not used as frames. Cannot be combined with first_frame_url or last_frame_url. | |
| reference_video_urls | No | Seedance 2.0 only. Reference video URLs (up to 3) for subject, camera movement, motion or overall style. Ignored by 1.x models. | |
| execution_expires_after | No | Task timeout threshold in seconds. Default is 172800 (48 hours). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |