Bytedance Seedance 2.0 Fast Reference To Video Turbo API Documentation

Bytedance Seedance 2.0 Fast Reference To Video Turbo API Documentation

Playground

Seedance 2.0 Fast Turbo Reference to Video creates cinematic videos with native audio from your own reference images, videos, and audio, keeping characters, products, motion, and sound consistent while a prompt directs the new shot. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Seedance 2.0 Fast Turbo Reference-to-Video guides generation with your own reference images, videos, and audio. Keep characters, products, scenes, motion, and soundtrack consistent while a prompt directs the new shot, with native synchronized audio and director-style control over camera, lighting, and pacing. The same reference inputs are also accepted by Seedance 2.0 Fast Turbo Text-to-Video.

Key Features

• Fastest Seedance option Speed-optimized inference for maximum throughput.

• Affordable HD output Starting at $0.60 per 5 seconds at 720p.

• Unified multimodal architecture Same Seedance 2.0 foundation handling text, image, audio, and video inputs.

• Native audio-visual synchronization Generates video with synchronized audio in a single pass.

• Director-level control Camera movement, lighting, shadows, and character performance controlled through prompts.

Parameters

Pricing

Pricing is calculated upfront using your selected duration, plus reference-video charges when applicable.

Without reference videos

Output-only pricing:

With reference videos

Pricing has two parts:

• Normalized reference-video duration + requested generation duration: $0.065 per second.
• Output upscale: $0.02 per requested second at 720p or $0.04 per requested second at 1080p.

Each reference video is normalized to at least 2 seconds, each clip and the combined input are capped at 15 seconds, and the normalized combined input duration is rounded up to a whole second for billing.

Best Use Cases

• Maximum Speed — Fastest possible Seedance generation at HD resolution.
• High-Volume Production — Most cost-effective HD generation for large content libraries.
• Rapid Prototyping — Quick iteration on HD concepts before upgrading to standard quality.
• A/B Testing — Generate many variations efficiently.

Pro Tips

• Use this for maximum speed and lowest cost at HD resolution.
• Switch to standard Seedance 2.0 for final production quality.
• Write prompts like a film director — include lighting, camera angles, and mood.
• Start with 5s to iterate, then extend once the look is right.

Notes

• Native audio generation included.
• Resolution options: 720p and 1080p only (turbo mode with speed-optimized inference).
• Duration range: 4–15 seconds, in whole seconds.

Related Models

• Seedance 2.0 Fast Reference-to-Video — Speed-optimized generation.
• Seedance 2.0 Reference-to-Video Turbo — Standard inference turbo mode.
• Seedance 2.0 Reference-to-Video — Highest quality generation.

Notice: Use @Image 1, @Image 2, @Audio 1, etc. to reference your uploaded assets. Number each type separately, in upload order.

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'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "enable_web_search": false,
  "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.0-fast/reference-to-video-turbo" \
  -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

Parameters

Task Submission Parameters

Request Parameters

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

Response Parameters

Result Request Parameters

Result Response Parameters