Seedance 2.5

by Bytedance

bytedance/seedance-2.5

Generate a video from text and reference media.

Billed per
token
Price
without_video (default): Price: $0.0000107with_video: Price: $0.0000064
Provider
Bytedance
Timeout
25 min

Overview

Generate a 4–30 second video with optional synchronized audio. 480p and 720p output are supported. Accepts text, image, video and audio content. Audio requires text, image or video. Any video reference selects the with_video output-token tier; other inputs use without_video. See the pricing table for your plan rates. 4K output is unsupported. Billing uses the completed task's output tokens.

After COMPLETED, read run.output.video_url, run.output.duration and run.output.resolution. Download the temporary video URL promptly.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
promptstringNoDescribe the scene and movement. Use either prompt or content.
contentarrayNoNonempty native text/image_url/video_url/audio_url items; media URLs require HTTPS, images also accept inline PNG/JPEG/WebP data. Optional roles: first_frame/reference_image, reference_video, reference_audio. Mutually exclusive with prompt.
input_modestringNoOptional assertion of the automatically derived content tier. Must match the supplied content.
Allowed: without_video, with_video
resolutionstringNoOutput resolution.
Allowed: 480p, 720p
Default: "720p"
durationintegerNoRequested duration: -1 for automatic, or 4–30 seconds. Output uses actual measured duration.
Default: 5
ratiostringNoOutput aspect ratio.
Allowed: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Default: "adaptive"
generate_audiobooleanNoGenerate synchronized audio.
Default: true
output_formatstringNoOutput video container.
Allowed: mp4, mov
watermarkbooleanNoAdd a generation watermark.
Default: false

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"bytedance","endpoint":"seedance-2.5","input":{"prompt":"A blue sphere slowly rotates on a white background.","duration":5,"resolution":"720p"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

without_video (default): $0.0000107 · with_video: $0.0000064 per token using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions