Video
Seedance 2 video
ByteDance Seedance 2 — text/image/reference + start-last frame. 480p–1080p. Optional audio.
Category: Create · seedance-2
Capabilities
What this model supports, straight from the schema — no pricing, no infrastructure detail.
| Capability | Value |
|---|---|
video_edit Video edit | — |
text_to_video Text-to-video | Yes |
image_to_video Image-to-video | Yes |
audio_generation Audio generation | Yes |
first_last_frame First + last frame | Yes |
reference_to_video Reference-to-video | Yes |
multimodal_reference Multimodal reference | Yes |
Parameters
Fields accepted in params (or first-class, where applicable) for POST /generations.
| Name | Label | Type | Required | Default | Options | Min / Max |
|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Required | — | — | — |
image_urls | Image references | multi_select | Optional | — | — | — – 2 |
reference_image_urls | Reference images | multi_select | Optional | — | — | — – 9 |
reference_audio_urls | Reference audio | multi_select | Optional | — | — | — – 3 |
resolution | Resolution | select | Required | 720p | 480p · 720p · 1080p · 4k | — |
generate_audio | Generate audio | boolean | Optional | false | — | — |
seed | Seed | number | Optional | — | — | — |
negative_prompt | Negative prompt | textarea | Optional | — | — | — |
duration | Duration | number | Required | 5 | — | 4 – 15 |
reference_video_urls | Reference videos | multi_select | Optional | — | — | — – 3 |
aspect_ratio | Aspect ratio | select | Optional | 16:9 | 1:1 · 21:9 · 4:3 · 3:4 · 16:9 · 9:16 | — |
Example request
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2",
"prompt": "a neon crab on a beach at sunset, cinematic style",
"params": {
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "seedance-2",
"prompt": "a neon crab on a beach at sunset, cinematic style",
"params": {
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}
}),
});
const { data } = await res.json();
Example response
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "seedance-2",
"type": "video",
"status": "completed",
"credits_charged": 40,
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
The job's real cost is returned as credits_charged on the completed response — check GET /balance for the account balance.
Common errors for this job type:
insufficient_credits | Account balance can't cover the job cost. |
content_policy_violation | Prompt or media rejected by content policy. |
generation_timeout | The job exceeded the maximum processing time. |
rate_limited | Too many requests per minute. |
invalid_input | A required parameter is missing or outside the model's schema. |
generation_failed | Generic processing failure. |