curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic city reveal after rain, smooth dolly shot, reflective streets, natural ambience.",
"resolution": "4k",
"duration": 5,
"aspect_ratio": "auto",
"generate_audio": true,
"return_last_frame": true,
"web_search": false,
"seed": 42
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-17T10:30:00"
}
}Seedance
Seedance 2 Video Generation
Text-to-video, first and last frame, and multimodal reference generation with Seedance 2 and Seedance 2 Fast
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic city reveal after rain, smooth dolly shot, reflective streets, natural ambience.",
"resolution": "4k",
"duration": 5,
"aspect_ratio": "auto",
"generate_audio": true,
"return_last_frame": true,
"web_search": false,
"seed": 42
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-17T10:30:00"
}
}- After submission, a
task_idis returned immediately. If you provide acallback_url, Vidgo sends a POST request to that URL when the task reachesfinishedorfailed. - You can always fetch the latest task result through the unified Query Task Status endpoint.
Seedance 2 Video Generation
Seedance 2 is ByteDance’s multimodal video family for API-based generation. On Vidgo API, you can choose between seedance-2 for higher fidelity and seedance-2-fast for lower-latency generation, while keeping a single submit and status API.Available Models
- seedance-2: Higher-quality video generation with multimodal references and native audio support
- seedance-2-fast: Faster generation path with the same submit schema and lower per-second pricing
Supported Generation Modes
- Text to Video: Generate directly from a prompt
- First and Last Frame: Guide motion between one or two frame anchors via
image_urls - Multimodal Reference: Add reference images, videos, and audio through
reference_image_urls,reference_video_urls, andreference_audio_urls
Input Rules
resolution:seedance-2supports480p,720p,1080p, and4k;seedance-2-fastsupports480pand720pdurationaccepts integer values from4to15image_urlssupports up to2itemsimage_urlsis mutually exclusive with allreference_*_urlsfieldsreference_image_urlssupports up to9items;reference_video_urlsandreference_audio_urlseach support up to3itemsreference_audio_urlsrequires at least onereference_image_urlsorreference_video_urlsitem- Total reference inputs across image, video, and audio fields can contain at most
12files aspect_ratiosupportsauto,1:1,21:9,4:3,3:4,16:9, and9:16generate_audio,return_last_frame, andweb_searchare optional boolean controls
Seedance 2 vs Seedance 1.5 Pro vs Seedance 1.0 Pro
- Seedance 2 adds multimodal reference image, video, and audio guidance with first and last frame control in one API shape.
- Seedance 1.5 Pro focuses on high-quality text-to-video and image-to-video generation with optional audio but without the same multimodal reference set.
- Seedance 1.0 Pro remains a strong option for earlier Seedance use cases, but Seedance 2 expands creative control and API flexibility for newer production pipelines.
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Seedance 2 model identifier
Available options:
seedance-2, seedance-2-fast Input parameters for Seedance 2 generation. image_urls cannot be combined with any reference_*_urls field.
Show child attributes
Show child attributes
Optional webhook callback URL for result notifications.
Example:
"https://your-domain.com/callback"