Seedance 2
Seedance 2
Seedance 2 video generation with text-to-video, image-to-video, and multimodal reference support
- Endpoint
- POST /api/v1/videos/generate
- model
- seedance2, seedance2-fast
- Output
- Video
- Credits
- from 30
Отправить задачу
/api/v1/videos/generateПараметры
modelstringТребуется"seedance2" for Pro quality or "seedance2-fast" for Fast quality
seedance2seedance2-fastmodestringОпционально"standard", "real", or "wild" rendering mode. channel is accepted as an alias.
standardrealwildtypestringОпционально"text-to-video", "image-to-video", or "media-to-video" (auto-detected from media_urls/image_urls when omitted)
text-to-videoimage-to-videomedia-to-videopromptstringТребуетсяText prompt (3-2500 chars)
media_urlsstring[]ОпциональноReference media URLs. Supports images, videos (MP4/MOV) and audio (MP3/WAV); detected by file extension. Video and audio are billed per second by their length, which is measured when you submit.
image_urlsstring[]ОпциональноImage-only reference URLs. media_urls takes precedence when both are provided.
input_imagestringОпциональноDeprecated. Alias for image_urls[0]
aspect_ratiostringОпциональноПо умолчанию16:9"1:1", "21:9", "4:3", "3:4", "16:9", or "9:16" (default: 16:9)
1:121:94:33:416:99:16durationstringОпциональноПо умолчанию4"4" through "15" seconds (default: 4)
resolutionstringОпциональноПо умолчанию720p"720p" or "1080p" (default: 720p). "480p" is additionally available only when mode is omitted. Resolution values select quality presets; actual encoding profiles are tuned per mode.
720p1080p480pfallbackbooleanОпциональноAllow automatic service fallback when available (default behavior)
truefalseseedintegerОпционально-1 to 4294967295. Fixes the generation seed for reproducibility. Supported by explicit "standard", "real", and "wild" modes, including real-mode asset:// inputs. When mode is omitted, the parameter is accepted but ignored.
Seedance prompt guide
Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style and constraints, then say what each reference file is for.
- For image-to-video, the first image is the opening frame and an optional second image is the closing frame. For reference media, pass images, videos and audio in media_urls.
- Describe each reference's role in the prompt in plain words ("the supplied cup", "the camera move from the supplied video"); do not refer to files by number or id.
- For edits say "strictly edit the supplied source video"; to continue a clip say "continue from the supplied previous clip".
- For complex scenes, list the shots in order, then a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo and no subtitles unless intended.
Запрос
curl -X POST https://www.bananapro.site/api/v1/videos/generate \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance2",
"mode": "standard",
"type": "text-to-video",
"prompt": "A cinematic drone shot over a futuristic coastal city at sunrise",
"aspect_ratio": "16:9",
"duration": "8",
"resolution": "1080p",
"seed": 12345
}'Ответ200
{
"success": true,
"data": {
"task_id": "task_seedance2_123",
"credits_used": 175,
"remaining_credits": 825,
"model": "seedance2",
"mode": "standard"
}
}Значения credits_used в этих примерах приведены для иллюстрации. Фактический расход рассчитывается при отправке и возвращается API.
Запросить задачу
/api/v1/videos/{task_id}status
pending- Accepted and waiting to start. Keep polling.
processing- Running. Keep polling.
completed- Finished. Read video_url; output holds the full result.
failed- Ended without a result. error_message says why and credits_refunded shows what was returned.
Poll every 5 to 10 seconds and stop at completed or failed, or register a webhook to be notified instead. Failed tasks are refunded automatically.
Запрос
curl https://www.bananapro.site/api/v1/videos/task_abc123 \
-H "Authorization: Bearer sk-your-api-key"Ответ200
{
"success": true,
"data": {
"task_id": "task_abc123",
"model": "seedance2",
"status": "completed",
"output": { "video_url": "https://..." },
"video_url": "https://...",
"error_message": null,
"credits_used": 175,
"credits_refunded": 0,
"created_at": "2026-10-04T10:00:00.000Z",
"updated_at": "2026-10-04T10:01:12.000Z",
"completed_at": "2026-10-04T10:01:12.000Z"
},
"request_id": "req_abc123"
}Дождаться результата
TASK_ID=task_abc123
while true; do
TASK=$(curl -s https://www.bananapro.site/api/v1/videos/$TASK_ID \
-H "Authorization: Bearer sk-your-api-key")
STATUS=$(echo "$TASK" | jq -r '.data.status')
if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
echo "$TASK" | jq
break
fi
sleep 10
doneЦены
| Model / Resolution | 4s | 8s | 12s | 15s |
|---|---|---|---|---|
| seedance2-fast / 720p | 30 | 65 | 95 | 120 |
| seedance2 / 720p | 40 | 80 | 120 | 150 |
| seedance2 / 1080p | 90 | 175 | 265 | 330 |
Prices are for the standard and wild modes with text/image inputs. The real mode costs 1.2x before final credit rounding. Omitting mode uses a separate fixed price table with slightly different totals. Video or audio references add per-second media-reference pricing.
Особенности
- Text-to-video generation
- Image-to-video generation
- Image, video, and audio reference inputs
- Fast and Pro model options
- Standard, real-person, and wild rendering modes
- 4-15 second outputs