Control generation with reference materials
Reference mode can combine images, video, and audio. Every submitted material must be explicitly referenced in the prompt, and array order should match prompt order.
Material rules
- Use a public HTTPS URL that the service can fetch directly.
- Do not use localhost, private IPs, HTTP, URL user information, or fragments.
- Do not depend on cookies, authorization headers, hotlink protection, or short-lived signatures.
- Do not repeat the same source URL or reuse one URL across material types.
- Keep the array order aligned with references in the prompt.
Prompt material labels
| Material | Prompt label |
|---|---|
| Image | @图片1, @图片2, ... |
| Video | @视频1, @视频2, ... |
| Audio | @音频1, @音频2, ... |
{
"model": "seedance2.5",
"prompt": "The girl in @图片1 turns to the camera; voice follows @音频1 and motion follows @视频1",
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"references": [
{
"type": "image",
"role": "reference",
"source": "https://cdn.example.com/girl.png"
},
{
"type": "audio",
"role": "reference",
"source": "https://cdn.example.com/voice.mp3"
},
{
"type": "video",
"role": "reference",
"source": "https://cdn.example.com/motion.mp4"
}
]
}Reference every submitted material
For two images and one video, the prompt must include @图片1, @图片2, and @视频1. Otherwise the request may be rejected.
Model limits
| Model family | Images | Videos | Audio |
|---|---|---|---|
| Seedance 2.0 | 9 | 3 | 3 |
| Seedance 2.5 | 30 | 10 | 10 |
First and last frame guide
Constrain the opening and ending images.
Tasks and errors
Handle 400, 429, and failed tasks.