Model reference
Seedance 2
Second-generation ByteDance video model with three speed tiers, clips up to 15 seconds, and references from images, video, or audio.
| Property | Value |
|---|---|
modelSlug | seedance-2 |
| Kind | Video |
| Maker | ByteDance |
Copies per request (variations) | 1 to 5 |
| How the cost is counted | per second of output (from duration), at a rate that depends on tier, mode and resolution, and whether reference_videos holds a file; plus the length of the clips in reference_videos when filled |
| Over MCP | yes, with the generate tool |
Credit amounts are left out because they change. The lowest price is creditCost on GET /v1/models, and POST /v1/jobs answers with the exact creditCost of a request.
input fields
Send the fields below inside the input object. A field you leave out takes its Default. Unknown field names are dropped without an error, so check the spelling if a setting seems to have no effect.
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
prompt | string | yes | – | 3 to 20,000 characters |
tier | string (one of) | – | standard | standard, fast, mini |
mode | string (one of) | – | text | text, frames, reference |
frames | string[] (image upload ids) | – | – | Start and end frames. Up to 2 files |
reference_images | string[] (image upload ids) | – | – | Reference images. Up to 9 files |
reference_videos | string[] (video upload ids) | – | – | Reference videos. Up to 3 files |
reference_audios | string[] (audio upload ids) | – | – | Reference audio. Up to 3 files |
aspect_ratio | string (one of) | – | 16:9 | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
resolution | string (one of) | – | 720p | 480p, 720p, 1080p, 4k |
duration | integer | – | 5 | 4 to 15 |
generate_audio | boolean | – | true | – |
Rules by setting
This model runs a different version depending on what you send. The rules below are checked before any credits move; a request that breaks one is refused with 400 and a message naming the field.
tier = standard and mode = text
- Takes no files in
frames,reference_images,reference_videosandreference_audios; a request that fills one is refused.
tier = standard and mode = frames
- Takes no files in
reference_images,reference_videosandreference_audios; a request that fills one is refused. frames: up to 2 files; in order: the first file is the start frame, the second the end frame; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.
tier = standard and mode = reference
- Takes no files in
frames; a request that fills one is refused. reference_images: up to 9 files; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.reference_videos: up to 3 files; at most 50 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5; 409,600 to 927,408 pixels in area.reference_audios: up to 3 files; at most 15 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total.
tier = fast and mode = text
- Takes no files in
frames,reference_images,reference_videosandreference_audios; a request that fills one is refused. resolutiontakes only480p,720p.
tier = fast and mode = frames
- Takes no files in
reference_images,reference_videosandreference_audios; a request that fills one is refused. frames: up to 2 files; in order: the first file is the start frame, the second the end frame; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.resolutiontakes only480p,720p.
tier = fast and mode = reference
- Takes no files in
frames; a request that fills one is refused. reference_images: up to 9 files; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.reference_videos: up to 3 files; at most 50 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5; 409,600 to 927,408 pixels in area.reference_audios: up to 3 files; at most 15 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total.resolutiontakes only480p,720p.
tier = mini and mode = text
- Takes no files in
frames,reference_images,reference_videosandreference_audios; a request that fills one is refused. resolutiontakes only480p,720p.
tier = mini and mode = frames
- Takes no files in
reference_images,reference_videosandreference_audios; a request that fills one is refused. frames: up to 2 files; in order: the first file is the start frame, the second the end frame; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.resolutiontakes only480p,720p.
tier = mini and mode = reference
- Takes no files in
frames; a request that fills one is refused. reference_images: up to 9 files; at most 30 MB per file; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5.reference_videos: up to 3 files; at most 50 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total; sides 300 to 6,000 px; width to height ratio 0.4 to 2.5; 409,600 to 927,408 pixels in area.reference_audios: up to 3 files; at most 15 MB per file; each clip 2 to 15 seconds long; at most 15 seconds in total.resolutiontakes only480p,720p.
Example request
{
"modelSlug": "seedance-2",
"input": {
"prompt": "The camera circles slowly around a steaming cup of coffee on a wooden table"
}
}