seedance_generate_video
Turn any text prompt into an AI-generated video clip. Describe the scene, motion, style, or mood to create a video with URLs and metadata, no reference images required.
Instructions
Generate AI video from a text prompt using ByteDance Seedance.
This is the simplest way to create video - just describe what you want and
Seedance will generate a high-quality AI video.
Use this when:
- You want to create a video from a text description
- You don't have reference images
- You want quick text-to-video generation
For using reference images (first/last frame, reference), use
seedance_generate_video_from_image instead.
Returns:
Task ID and generated video information including URLs and metadata.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Random seed for reproducible generation. Range: -1 to 4294967295. Use -1 for random. Default is -1. | |
| model | No | Model version to use. Options: 'doubao-seedance-2-5-260628' (latest flagship, up to 30 seconds, multimodal reference, edit/extend, default), 'doubao-seedance-2-0-260128' (highest resolution, supports 4k), 'doubao-seedance-2-0-fast-260128' (latest generation, faster, up to 720p), 'doubao-seedance-2-0-mini-260615' (latest generation, lightweight, cheapest within the 2.0 series, up to 720p), 'doubao-seedance-1-5-pro-251215' (1.5 flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (1.0 standard), 'doubao-seedance-1-0-pro-fast-251015' (1.0 fast, cost-optimized), 'doubao-seedance-1-0-lite-t2v-250428' (lightweight text-to-video), 'doubao-seedance-1-0-lite-i2v-250428' (lightweight image-to-video). | doubao-seedance-2-0-260128 |
| ratio | No | Video aspect ratio. Options: '16:9' (landscape, default), '9:16' (portrait), '1:1' (square), '4:3', '3:4', '21:9' (ultrawide), 'adaptive'. | 16:9 |
| tools | No | Optional Seedance 2.5 web search tool configuration. | |
| frames | No | Frame count for the generated video (1.0 series only). Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'. | |
| prompt | Yes | Description of the video to generate. Max 1000 characters. Be descriptive about the scene, motion, style, and mood. You can also include inline parameters like '--rs 720p --rt 16:9 --dur 5'. Examples: 'A cat walking through a garden with butterflies', 'Cinematic aerial shot of mountains at sunset' | |
| duration | No | Video duration in seconds. 1.0 series: 2–12; 1.5 Pro: 4–12; 2.0 series: 4–15; 2.5: 4–30. Use -1 for auto-duration (1.5 Pro and 2.x). Default is 5. Mutually exclusive with 'frames'. | |
| priority | No | Seedance 2.5 task priority from 0 to 9. | |
| watermark | No | If true, add a watermark to the video. Default is false. | |
| resolution | No | Video resolution. Options: '480p', '720p' (default), '1080p', '4k'. '4k' is supported only by 'doubao-seedance-2-0-260128'; '2-5' maxes out at '1080p'; '2-0-fast' and '2-0-mini' max out at '720p'. | 720p |
| callback_url | No | Webhook callback URL for asynchronous notifications. When provided, the API returns immediately with a task_id and calls this URL when the video is generated. | |
| camera_fixed | No | If true, keep the camera fixed during generation. Default is false. | |
| output_format | No | Seedance 2.5 output format: mp4 or mov. | |
| generate_audio | No | If true, generate audio along with the video. Supported by 'doubao-seedance-1-5-pro-251215' and the 'doubao-seedance-2-0' series; other models ignore it. Approximately doubles the cost. Default is false. | |
| return_last_frame | No | If true, also return the last frame of the generated video as an image URL. Useful for video extension workflows. Default is false. | |
| safety_identifier | No | Stable anonymous end-user identifier. Do not use personal information. | |
| execution_expires_after | No | Task timeout threshold in seconds. Default is 172800 (48 hours). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |