Seedance 2.5 Video API Reference | Nano Banana Pro API

Seedance 2.5

Seedance 2.5 video with synchronized audio: text, image or mixed image / video / audio references, 4 to 30 seconds or auto length, up to 2K

Endpoint: POST /api/v1/videos/generate
model: seedance25
Output: Video
Credits: 15 per second at 720p

إرسال مهمة

POST/api/v1/videos/generate

المُعاملات

modelstringمطلوب
Must be "seedance25"
typestringاختياري
"text-to-video", "image-to-video" or "media-to-video" (detected from media_urls when omitted). video-to-video is not supported
text-to-videoimage-to-videomedia-to-video
promptstringمطلوب
Text prompt, up to 10000 characters
media_urlsstring[]اختياري
Public https URLs of reference images, videos and audio. Required for image-to-video and media-to-video
image_urlsstring[]اختياري
Image-only references; media_urls takes precedence
aspect_ratiostringاختياريالافتراضي 16:9
"16:9" (default), "9:16", "1:1", "4:3", "3:4", "21:9" or "adaptive". Image-to-video follows the first frame; editing or extending a video requires "adaptive"
16:99:161:14:33:421:9adaptive
durationstringاختياريالافتراضي auto
"auto" (default) or "4" to "30" seconds. With "auto", credits for 30 seconds are reserved and the difference is refunded once the clip is ready. Editing or extending a video requires "auto"
auto4–30
resolutionstringاختياريالافتراضي 1080p
"720p", "1080p" (default) or "1080p-plus" (2K)
720p1080p1080p-plus
channelstringاختياريالافتراضي standard
"standard" (default), "real" or "wild". Use real when references show real people
standardrealwild
generate_audiobooleanاختياريالافتراضي true
Generate synchronized audio (default: true)
truefalse

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" \
  -H "Idempotency-Key: docs-seedance25-text-001" \
  -d '{
    "model": "seedance25",
    "type": "text-to-video",
    "prompt": "A paper boat drifting down a rain-soaked street at dusk, reflections shimmering",
    "aspect_ratio": "16:9",
    "duration": "4",
    "resolution": "720p"
  }'

الرد200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_seedance25_123",
    "credits_used": 60,
    "remaining_credits": 940,
    "model": "seedance25"
  }
}

قيم 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": "seedance25",
    "status": "completed",
    "output": { "video_url": "https://..." },
    "video_url": "https://...",
    "error_message": null,
    "credits_used": 60,
    "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

التسعير

Resolution	Without video input	With video input
720p	15	10
1080p	35	21
1080p-plus (2K)	85	51

Credits per billable second, rounded to the nearest 5. Without video input, billable seconds are the output seconds; with a reference video they are max(4, input video seconds) + output seconds. The real channel costs 1.2x. duration "auto" reserves 30 seconds when submitted and refunds the difference once the clip is ready; credits_refunded shows it.

المزايا

Text-to-video, image-to-video (first frame, or first and last frame) and media-to-video
Up to 30 images, 10 videos and 10 audio clips as references (50 files, 30 s of video or audio in total)
4–30 second clips, or duration "auto" to let the model choose
720p, 1080p and 1080p-plus (2K) output with generated audio
standard, real (for references with real people) and wild channels

curl -X POST https://www.bananapro.site/api/v1/videos/generate \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: docs-seedance25-text-001" \ -d '{ "model": "seedance25", "type": "text-to-video", "prompt": "A paper boat drifting down a rain-soaked street at dusk, reflections shimmering", "aspect_ratio": "16:9", "duration": "4", "resolution": "720p" }'

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

التسعير

Resolution	Without video input	With video input
720p	15	10
1080p	35	21
1080p-plus (2K)	85	51

المزايا

Text-to-video, image-to-video (first frame, or first and last frame) and media-to-video

Up to 30 images, 10 videos and 10 audio clips as references (50 files, 30 s of video or audio in total)

4–30 second clips, or duration "auto" to let the model choose

720p, 1080p and 1080p-plus (2K) output with generated audio

standard, real (for references with real people) and wild channels