Seedance API Guide
Integrate Seedance video generation into your application. Choose your platform and language below.
Quick Start
Install the fal.ai client and set your API key.
import fal_client
# Set FAL_KEY environment variable or pass directly
result = fal_client.subscribe(
"fal-ai/seedance/text-to-video",
arguments={
"prompt": "A golden retriever running through a sunflower field, cinematic lighting",
"duration": 5,
"aspect_ratio": "16:9",
},
)
print(result["video"]["url"])Available Models
| Model | ID | Type | Resolution |
|---|---|---|---|
| Seedance Text-to-Video | fal-ai/seedance/text-to-video | Text → Video | 1080p |
| Seedance Image-to-Video | fal-ai/seedance/image-to-video | Image → Video | 1080p |
| Seedance Lite | fal-ai/seedance-lite | Text → Video | 480p |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Text description of the desired video content |
| image | string (URL) | No | Reference image URL for image-to-video generation |
| duration | number | No | Video duration in seconds (4–15, default: 5) |
| aspect_ratio | string | No | Output aspect ratio: "16:9", "9:16", "1:1" |
| resolution | string | No | Output resolution (platform-dependent) |
| audio | boolean | No | Enable audio generation (Seedance 2.0 only) |
| seed | number | No | Random seed for reproducible results |
Error Troubleshooting
401Invalid or missing API key
Check your API key is set correctly in environment variables
422Invalid parameters
Verify prompt is not empty and duration is within allowed range
429Rate limit exceeded
Wait and retry, or upgrade your plan for higher limits
500Server error
Retry after a few seconds. If persistent, check platform status page
NSFWContent moderation triggered
Modify your prompt to avoid restricted content
Not a developer? Use Seedance through the web interface or check our registration guide.