seedance_generate_video
Create AI videos directly from text descriptions. Describe your scene, motion, style, and mood to generate high-quality video without reference images.
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-0-260128' (latest generation, highest quality, supports 4k and multimodal reference, default), '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 |
| 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 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. Range: 2-15 (Seedance 2.0 supports 4-15). Default is 5. Mutually exclusive with 'frames'. | |
| 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-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. | |
| service_tier | No | Service tier. 'default' for standard processing, 'flex' for 50%% cheaper but slower processing. Default is 'default'. | default |
| 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. | |
| execution_expires_after | No | Task timeout threshold in seconds. Default is 172800 (48 hours). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |