Bytedance Seedance 2.5 Flash Image To Video Spicy API Documentation

Bytedance Seedance 2.5 Flash Image To Video Spicy API Documentation

Playground

Try it on WaveSpeedAI!

Seedance 2.5 Flash Spicy Image-to-Video animates a start image with an optional prompt and last frame, with 480p or 720p output and optional generated audio. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Seedance 2.5 Flash Spicy Image-to-Video animates a start image into a cinematic video, with an optional last frame. Choose a duration of 4 to 30 seconds, 480p or 720p output, and optional synchronized audio.


Why Choose This?

  • Native audio
    Enable audio generation for dialogue, sound effects and ambience.

  • Director-style prompt control
    Direct camera movement, lighting, performance, atmosphere and pacing through the prompt.

  • Up to 30 seconds
    Generate clips from 4 to 30 seconds in one request.

  • 480p and 720p output
    Choose the resolution that fits the job.


Parameters

ParameterRequiredDescription
imageYesStart image URL.
promptNoDescribe the motion, camera movement and mood.
last_imageNoOptional last-frame image URL.
durationNoVideo length in whole seconds, 4–30. Default: 5.
resolutionNo480p or 720p. Default: 720p.
generate_audioNoGenerate synchronized audio. Default: true.

How to Use

  1. Provide a start image and optionally add a last-frame image.
  2. Optionally add a prompt describing the action and camera movement.
  3. Set duration and resolution: 4–30 whole seconds, 480p or 720p.
  4. Submit and retrieve the output URL.

Pricing

Output only

Price per second, by resolution (rate shown for a 10-second duration):

ResolutionPer second (duration 10 s)
480p$0.12 $0.108
720p$0.24 $0.216

Price per video, by resolution and duration:

Resolution4 seconds5 seconds10 seconds30 seconds
480p$0.48 $0.432$0.60 $0.54$1.20 $1.08$3.60 $3.24
720p$0.96 $0.864$1.20 $1.08$2.40 $2.16$7.20 $6.48

Pricing is based on the selected generation duration, from 4 to 30 whole seconds. A request with default settings (720p, 5 seconds) costs $1.20 $1.08 per run.


Best Use Cases

  • Ad and social creative: test concepts and produce short clips in volume.
  • Concept visualization: turn ideas into motion previews for pitching and storyboarding.
  • Audio-driven scenes: clips with synchronized sound for ambience, music or narrative moments.

Pro Tips

  • Write prompts like a shot list: subject, action, camera, lighting, mood.
  • Start with a short duration while testing a prompt, then lengthen once the direction works.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}
JSON
)

# 1. Submit the prediction once. Never retry this request automatically:
# a retry after an unclear failure can create a second, billed task.
CHECK='The task may already exist. Check History or the predictions list before submitting again.'
if ! SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/bytedance/seedance-2.5-flash/image-to-video-spicy" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"); then
  printf 'Submit failed. %s\n' "${CHECK}" >&2
  exit 1
fi

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id. %s\n' "${CHECK}" >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction reaches a final status.
BODY_FILE=$(mktemp)
trap 'rm -f "${BODY_FILE}"' EXIT
while true; do
  # Transient errors (429, 5xx) are retried, honoring Retry-After.
  HTTP_CODE=$(curl --silent --show-error --fail-with-body \
    --connect-timeout 10 --max-time 60 --retry 5 --retry-delay 2 \
    --output "${BODY_FILE}" --write-out '%{http_code}' \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}" || true)
  case "${HTTP_CODE}" in
    2??) ;;
    000|429|5??)  # dropped connection or temporary error: keep polling
      printf 'Task %s: HTTP %s, polling again in 10s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      sleep 10; continue ;;
    *) printf 'Task %s: HTTP %s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      cat "${BODY_FILE}" >&2; exit 1 ;;
  esac
  RESULT=$(jq 'if type == "object" and has("data") then .data else . end' "${BODY_FILE}")
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted)
      printf 'Task %s ended with status %s\n' "${PREDICTION_ID}" "${STATUS}" >&2
      printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Retry temporary errors only while polling, never the submit request. Errors, retries and timeouts

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
imagestringYes-Start image URL to guide the video generation.
promptstringNo-Describe the scene, action, camera movement, and mood for the video.
last_imagestringNo--Last frame image URL for video continuation.
resolutionstringNo720p480p, 720pThe output video resolution.
durationintegerNo54 ~ 30The duration of the generated video in seconds (4-30s).
generate_audiobooleanNotrue-Whether to generate native audio synchronized with the output video. Defaults to true.
seedintegerNo--The random seed to use for the generation. -1 means a random seed will be used.

Every model also accepts the global request options enable_sync_mode and enable_base64_output; see their pages for details.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayOutput values, usually URL strings; some models return text strings or structured result objects (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.statusstringTask status. completed is successful; failed, cancelled, timeout, and deleted are failure terminal statuses.
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction
data.modelstringModel ID used for the prediction
data.outputsarray<string | object>Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.
data.urlsobjectObject containing related API endpoints
data.statusstringStatus: completed is successful; failed, cancelled, timeout, and deleted are failure terminal statuses
data.created_atstringISO timestamp of when the request was created
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2026 WaveSpeedAI. All rights reserved.