Volcengine official channel
Call Seedance using these four public model names. Generation and editing use the same PopGo video API.
Checking available models…
Choose a model
Select a model name for resolution, duration, aspect ratio and reference parameters. Check models and pricing for current access and prices.
Ordinary video generation
Follow the video workflow and call POST /v1/videos. Each model below has its full parameters and an example. Replace YOUR_MODEL with the model name in that section.
Add reference_images, reference_videos or reference_audios as needed, using arrays of publicly downloadable HTTPS media URLs. Use first_frame and last_frame for frame images; see the selected model parameters for combinations.
Generate with a reference image
This example works with all four models above. Replace YOUR_MODEL with the selected model name and YOUR_IMAGE_URL with a direct image URL.
{
"model": "YOUR_MODEL",
"prompt": "The subject in the reference image slowly turns its head; keep the camera steady.",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_images": [
"YOUR_IMAGE_URL"
]
}
Use an HTTPS URL that returns the image content directly without signing in, rather than a sharing page. A URL that opens in a browser may still be unavailable to the generation service. If an image download fails, check that the URL allows direct access from external services.
seedance-2-0
General video generation
| Field | Type | Required | Values and constraints | Default |
|---|---|---|---|---|
prompt | string | Yes | minLength=1; Describe the desired scene and motion. | Unspecified |
seconds | string | No | ≥ 4; ≤ 15; Output duration in seconds; use the range or values listed here. | 4 |
resolution | string | No | 480p, 720p, 1080p, 4k; Output resolution; values are case-sensitive. | 480p |
aspect_ratio | string | No | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; Output aspect ratio. | adaptive |
reference_images | array | No | maxItems=9 | Unspecified |
reference_videos | array | No | maxItems=3 | Unspecified |
reference_audios | array | No | maxItems=3 | Unspecified |
first_frame | string | No | First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
last_frame | string | No | Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
Ordinary video generation
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-0-fast
Fast video generation
| Field | Type | Required | Values and constraints | Default |
|---|---|---|---|---|
prompt | string | Yes | minLength=1; Describe the desired scene and motion. | Unspecified |
seconds | string | No | ≥ 4; ≤ 15; Output duration in seconds; use the range or values listed here. | 4 |
resolution | string | No | 480p, 720p; Output resolution; values are case-sensitive. | 480p |
aspect_ratio | string | No | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; Output aspect ratio. | adaptive |
reference_images | array | No | maxItems=9 | Unspecified |
reference_videos | array | No | maxItems=3 | Unspecified |
reference_audios | array | No | maxItems=3 | Unspecified |
first_frame | string | No | First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
last_frame | string | No | Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
Ordinary video generation
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-0-mini
Lightweight video generation
| Field | Type | Required | Values and constraints | Default |
|---|---|---|---|---|
prompt | string | Yes | minLength=1; Describe the desired scene and motion. | Unspecified |
seconds | string | No | ≥ 4; ≤ 15; Output duration in seconds; use the range or values listed here. | 4 |
resolution | string | No | 480p, 720p; Output resolution; values are case-sensitive. | 480p |
aspect_ratio | string | No | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; Output aspect ratio. | adaptive |
reference_images | array | No | maxItems=9 | Unspecified |
reference_videos | array | No | maxItems=3 | Unspecified |
reference_audios | array | No | maxItems=3 | Unspecified |
first_frame | string | No | First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
last_frame | string | No | Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
Ordinary video generation
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-5
Video generation and editing
| Field | Type | Required | Values and constraints | Default |
|---|---|---|---|---|
prompt | string | Yes | minLength=1; Describe the desired scene and motion. | Unspecified |
seconds | string | No | ≥ 0; ≤ 30; Ordinary generation: 4–30 seconds. Video editing: "0", together with mode=videoEdit2video. | 4 |
resolution | string | No | 480p, 720p, 1080p; Output resolution; values are case-sensitive. | 480p |
aspect_ratio | string | No | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; Output aspect ratio. | adaptive |
reference_images | array | No | maxItems=30 | Unspecified |
reference_videos | array | No | maxItems=10 | Unspecified |
reference_audios | array | No | maxItems=10 | Unspecified |
first_frame | string | No | First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
last_frame | string | No | Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules. | Unspecified |
mode | string | No | videoEdit2video; For seedance-2-5 video editing, set mode to videoEdit2video, seconds to "0" and aspect_ratio to adaptive. Provide one 4–30 second reference video; up to 30 images may be added. Omit audio references. For ordinary generation, omit mode. | Unspecified |
Ordinary video generation
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-5 video editing
For editing, select seedance-2-5 and use the same POST /v1/videos endpoint. Replace YOUR_MODEL below with that name and YOUR_VIDEO_URL with a directly downloadable HTTPS video URL.
{
"model": "YOUR_MODEL",
"prompt": "Make the scene look like a watercolor painting",
"seconds": "0",
"resolution": "720p",
"aspect_ratio": "adaptive",
"mode": "videoEdit2video",
"reference_videos": [
"YOUR_VIDEO_URL"
]
}
- Provide one 4–30 second reference video. You may add up to 30 reference images; omit audio references.
- Set
secondsto the string"0",modetovideoEdit2video, andaspect_ratiotoadaptive."0"selects editing based on the input video.
Query and retrieve the video
Save the returned id and query GET /v1/videos/{id}. When complete, use GET /v1/videos/{id}/content to play or download. Use the same API Key for all three requests; see the video workflow for full examples.