Seedance 2 Mini Video API Reference

Seedance 2 Mini

Seedance 2 Mini video generation — cost-efficient tier with native audio, 4-15s, native 480p/720p output (API resolution values remain 720p/1080p), standard / real / wild modes

Endpoint: POST /api/v1/videos/generate
model: seedance2mini
Output: Video
Credits: from 20

Отправить задачу

POST/api/v1/videos/generate

Параметры

modelstringТребуется
Must be "seedance2mini"
modestringОпциональноПо умолчанию real
"standard", "real", or "wild" rendering mode. channel is accepted as an alias. Defaults to the real mode when omitted.
standardrealwild
typestringОпционально
"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-video
promptstringТребуется
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:16
durationstringОпциональноПо умолчанию 4
"4" through "15" seconds (default: 4)
resolutionstringОпциональноПо умолчанию 720p
"720p" or "1080p" (default: 720p). These API values produce native 480p and 720p output respectively; billing is unchanged. Mini does not support 4k.
720p1080p
generate_audiobooleanОпциональноПо умолчанию true
Generate synchronized audio (default: true). Set to false for silent video.
truefalse
seedintegerОпционально
-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. Set "mode" explicitly for reproducible results.

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": "seedance2mini",
    "mode": "standard",
    "type": "text-to-video",
    "prompt": "A lone astronaut drifting toward a ringed planet, sunlight glinting off the visor",
    "aspect_ratio": "16:9",
    "duration": "4",
    "resolution": "720p",
    "seed": 12345
  }'

Ответ200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_seedance2mini_123",
    "credits_used": 20,
    "remaining_credits": 980,
    "model": "seedance2mini",
    "mode": "standard"
  }
}

Значения credits_used в этих примерах приведены для иллюстрации. Фактический расход рассчитывается при отправке и возвращается API.

Запросить задачу

GET/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

JSON

{
  "success": true,
  "data": {
    "task_id": "task_abc123",
    "model": "seedance2mini",
    "status": "completed",
    "output": { "video_url": "https://..." },
    "video_url": "https://...",
    "error_message": null,
    "credits_used": 20,
    "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

Цены

Mode / Resolution	4s	8s	12s	15s
Standard · Wild / 720p	20	40	60	75
Standard · Wild / 1080p	45	90	130	165
Real / 720p	30	55	85	105
Real / 1080p	60	120	180	225

Example pricing for text/image inputs. Resolution rows use the API values: 720p produces native 480p output and 1080p produces native 720p output. Standard and wild modes share the same rate; the real mode is billed slightly higher. Video or audio reference inputs incur additional per-second billing.

Особенности

Text-to-video, image-to-video, and media-to-video generation
Native audio generation
Standard, real-person, and wild rendering modes
Reproducible results via seed (explicit standard / real / wild modes)

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": "seedance2mini", "mode": "standard", "type": "text-to-video", "prompt": "A lone astronaut drifting toward a ringed planet, sunlight glinting off the visor", "aspect_ratio": "16:9", "duration": "4", "resolution": "720p", "seed": 12345 }'

{ "success": true, "data": { "task_id": "task_abc123", "model": "seedance2mini", "status": "completed", "output": { "video_url": "https://..." }, "video_url": "https://...", "error_message": null, "credits_used": 20, "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

Цены

Mode / Resolution	4s	8s	12s	15s
Standard · Wild / 720p	20	40	60	75
Standard · Wild / 1080p	45	90	130	165
Real / 720p	30	55	85	105
Real / 1080p	60	120	180	225