seedance_generate_video_from_image
Generate AI video from reference images using first frame, last frame, or style guidance. Animate specific images or create smooth transitions between two images.
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 |
|---|---|---|---|
| prompt | Yes | Description of the video motion and content. Describe what should happen in the video, how objects should move, what transitions to include. | |
| 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. | |
| 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. | |
| reference_image_urls | No | List of reference image URLs for style/content guidance. These images influence the look but are not used as frames. Cannot be combined with first_frame_url or last_frame_url. | |
| model | No | Model version to use. Use 'doubao-seedance-2-0-260128' for latest generation quality, 'doubao-seedance-2-0-fast-260128' for latest generation speed, For image-to-video, consider 'doubao-seedance-1-0-lite-i2v-250428' for lightweight I2V, or any Pro model for higher quality. | doubao-seedance-1-0-pro-250528 |
| resolution | No | Video resolution. Options: '480p', '720p', '1080p'. | 720p |
| ratio | No | Video aspect ratio. Use 'adaptive' to match your input image ratio. | 16:9 |
| duration | No | Video duration in seconds. Range: 2-12. Default is 5. Mutually exclusive with 'frames'. | |
| frames | No | Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'. | |
| generate_audio | No | If true, generate audio. Only supported by 1.5 Pro model. Default is false. | |
| service_tier | No | Service tier. 'default' or 'flex' (50%% cheaper). Default is 'default'. | default |
| seed | No | Random seed. -1 for random. Default is -1. | |
| return_last_frame | No | If true, return the last frame of the generated video. Default is false. | |
| callback_url | No | Webhook callback URL for asynchronous notifications. | |
| execution_expires_after | No | Task timeout threshold in seconds. Default is 172800 (48 hours). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |