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

Enviar una tarea

POST/api/v1/videos/generate

Parámetros

modelstringNecesario
Must be "seedance25"
typestringOpcional
"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
promptstringNecesario
Text prompt, up to 10000 characters
media_urlsstring[]Opcional
Public https URLs of reference images, videos and audio. Required for image-to-video and media-to-video
image_urlsstring[]Opcional
Image-only references; media_urls takes precedence
aspect_ratiostringOpcionalPredeterminado 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
durationstringOpcionalPredeterminado 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
resolutionstringOpcionalPredeterminado 1080p
"720p", "1080p" (default) or "1080p-plus" (2K)
720p1080p1080p-plus
channelstringOpcionalPredeterminado standard
"standard" (default), "real" or "wild". Use real when references show real people
standardrealwild
generate_audiobooleanOpcionalPredeterminado 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.

Solicitud

curl -X POST https://preview.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"
  }'

Respuesta200

JSON

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

Los valores de credits_used de estos ejemplos son ilustrativos. El consumo real se calcula al enviar y lo devuelve la API.

Consultar la tarea

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.

Solicitud

curl https://preview.bananapro.site/api/v1/videos/task_abc123 \
  -H "Authorization: Bearer sk-your-api-key"

Respuesta200

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"
}

Esperar el resultado

TASK_ID=task_abc123
while true; do
  TASK=$(curl -s https://preview.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

Precios

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.

Características

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://preview.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://preview.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

Precios

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

Características

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