seedance_generate_video
Create AI-generated videos from text descriptions using ByteDance Seedance technology. Input descriptive prompts to produce videos with customizable resolution, duration, and aspect ratio.
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 |
|---|---|---|---|
| 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' | |
| model | No | Model version to use. Options: 'doubao-seedance-1-5-pro-251215' (newest flagship, supports audio), 'doubao-seedance-1-0-pro-250528' (standard, default), 'doubao-seedance-1-0-pro-fast-251015' (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-1-0-pro-250528 |
| resolution | No | Video resolution. Options: '480p', '720p' (default), '1080p'. | 720p |
| 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 |
| 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 along with the video. Only supported by 'doubao-seedance-1-5-pro-251215' model. Approximately doubles the cost. Default is false. | |
| service_tier | No | Service tier. 'default' for standard processing, 'flex' for 50%% cheaper but slower processing. Default is 'default'. | default |
| seed | No | Random seed for reproducible generation. Range: -1 to 4294967295. Use -1 for random. Default is -1. | |
| camera_fixed | No | If true, keep the camera fixed during generation. Default is false. | |
| watermark | No | If true, add a watermark to the video. 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. | |
| 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. | |
| execution_expires_after | No | Task timeout threshold in seconds. Default is 172800 (48 hours). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |