Seedance 2.5 Image to Video

Name: ByteDance Seedance 2.5 Image to Video
Price: 1.44 USD
Availability: InStock
Author: ByteDance

20% OFFbytedance/seedance/2.5/image-to-video

ByteDance's next-generation image-to-video model, animating a single still into a native clip up to 30 seconds at 720p with continuous, coherent motion, native audio, and director-level camera control.

Try the model

Playground

Open playground

Input

Prompt(string)

The text prompt to generate a video from.

Image(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the starting image for video generation.

Additional Settings More

Customize your input with more control.

End Image(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the ending image for video generation.

Duration

Output duration in seconds (4-30), or `auto` to let the model pick a length from the prompt and inputs. `auto` is pre-authorized at 30 seconds and billed on the actual output length. Allowed values: auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30.

Resolution(string)

The resolution of the video to generate. Allowed values: 480p, 720p, 1080p.

Generate Audio(boolean)

Whether to generate synchronized audio (voice, SFX, BGM) for the video.

Seed(integer)

Random seed for reproducible results. Omit or use -1 for a random seed. Range: -1 to 4294967295.

Draft Mode (480p)(boolean)

Draft mode step 1: render a fast, low-cost 480p draft (overrides `resolution`, billed at the 480p rate). Pass the result's `outputs[0].draft_id` back as `draft_id` within 7 days to render the same shot at 1080p.

Draft ID(string)

Draft mode step 2: the `outputs[0].draft_id` of a succeeded draft from this same model (created with `draft: true` in the last 7 days). Renders the same shot at 1080p, billed at the 1080p rate for the actual output length. The prompt, media, duration, aspect ratio, seed, audio setting and task type are reused from the draft; any such fields sent with `draft_id` are ignored.

20% OFF

Result

Example

What would you like to do next?
Open original

Examples

Select an example to load its inputs and result into the playground.

Input

{
  "duration": 4,
  "generate_audio": false,
  "image": "https://static.sandbase.ai/examples/b6874082-35a0-47e4-8a3e-335b93f08c49/input/97cca825-cf32-47a2-8cf8-b53016742e54.png",
  "prompt": "The lantern sways in the wind",
  "resolution": "480p",
  "seed": 3
}

Open result ↗

Seedance 2.5 Image to Video

Seedance 2.5 image-to-video: image becomes the first frame and the prompt directs motion, camera, and sound. Add end_image to set the final frame.

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Up to 50,000 characters.
`image`	image URL, required	—	First frame. JPEG, PNG, or WebP URL.
`end_image`	image URL	—	Optional last frame.
`duration`	`auto` / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30	5	Output length in seconds (4–30), or `auto` to let the model choose.
`resolution`	`480p` / `720p` / `1080p`	`720p`	Sets the per-second rate.
`generate_audio`	boolean	true	Native dialogue, music, and effects. Same price on or off.
`seed`	integer -1–4294967295	random	Fix it to compare prompt changes; `-1` is random.

Billing

You pay for output seconds: $0.18 at 480p, $0.36 at 720p, $0.90 at 1080p. Audio is included. With duration: "auto" the quote assumes 30 seconds and the final charge uses the generated length.

Output	480p	720p	1080p
4s	$0.72	$1.44	$3.60
5s (default)	$0.90	$1.80	$4.50
10s	$1.80	$3.60	$9.00
15s	$2.70	$5.40	$13.50
30s	$5.40	$10.80	$27.00

Failed runs are not charged.

Prompting

Describe what moves and how the camera behaves, not what is already visible.
With two frames, describe the transition between them.

Limits

Clips are 4–30 seconds.

Draft mode

Draft mode is two calls to this same model:

Draft: add "draft": true. The output is a 480p preview billed at the 480p rate, and outputs[0].draft_id identifies it.
Final: send {"draft_id": "<outputs[0].draft_id>"} (optionally watermark). The same shot is rendered at 1080p and billed at the 1080p output rate for the actual output length.

The final reuses the draft's prompt, media, duration, aspect ratio, seed and audio setting; those fields are ignored when draft_id is set. A draft can be finalized within 7 days, only with the model that created it.

{"prompt": "Slow 360-degree orbit around the subject.", "image": "https://example.com/first-frame.png", "duration": 5, "draft": true}

{"draft_id": "<outputs[0].draft_id from the draft>"}

Also on SandBase

Other Seedance 2.5 endpoints and tiers: bytedance/seedance/2.5/text-to-video, bytedance/seedance/2.5/reference-to-video, bytedance/seedance/2.0/image-to-video, bytedance/seedance/2.0/fast/image-to-video, bytedance/seedance/2.0/mini/image-to-video.

Start building

Send your first request

Submit this model through the SandBase Unified Run API.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

bytedance/seedance/2.5/image-to-video

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "bytedance/seedance/2.5/image-to-video",
  "draft": false,
  "image": "https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f8fc1008f23a4908b7c897e8b7eb87df~tplv-goo7wpa0wc-image.image",
  "prompt": "Create a 360-degree orbiting camera shot based on this photo.",
  "duration": 5,
  "resolution": "720p",
  "generate_audio": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

2. Authentication

Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep the key on your server. Do not expose it in browser code or commit it to a repository.

3. Queue

Submit a request

POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.

Fetch request status and result

Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.

Poll run status

curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

4. Files

Hosted files

Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.

Uploading images

Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.

5. Schema

Input

`seed`integer

Random seed for reproducible results. Omit or use -1 for a random seed.

Minimum: -1

Maximum: 4294967295

`draft`boolean

Default: false

`image`string

The URL of the starting image for video generation.

`prompt`string

The text prompt to generate a video from.

Default: "Create a 360-degree orbiting camera shot based on this photo."

`draft_id`string

`duration`value

Output duration in seconds (4-30), or `auto` to let the model pick a length from the prompt and inputs. `auto` is pre-authorized at 30 seconds and billed on the actual output length.

Default: 5

Possible values: "auto", 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

`end_image`string

The URL of the ending image for video generation.

`resolution`string

The resolution of the video to generate.

Default: "720p"

Possible values: "480p", "720p", "1080p"

`generate_audio`boolean

Whether to generate synchronized audio (voice, SFX, BGM) for the video.

Default: true

Request body

{
  "model": "bytedance/seedance/2.5/image-to-video",
  "draft": false,
  "image": "https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f8fc1008f23a4908b7c897e8b7eb87df~tplv-goo7wpa0wc-image.image",
  "prompt": "Create a 360-degree orbiting camera shot based on this photo.",
  "duration": 5,
  "resolution": "720p",
  "generate_audio": true
}

Output

A completed run exposes its result in output. The following is the model’s saved example, not a new generation.

Example output JSON

[
  {
    "poster": "https://static.sandbase.ai/examples/posters/51843db67698f6a1143b.jpg",
    "source": "Self organization completed prediction",
    "source_url": "https://www.sandbase.ai",
    "url": "https://static.sandbase.ai/examples/b6874082-35a0-47e4-8a3e-335b93f08c49/output/912941bc-cbd5-40cc-b879-5d0fdb9a4f38.mp4"
  }
]

Seedance 2.5 Image to Video

Playground

Examples

Seedance 2.5 Image to Video

Fields

Billing

Prompting

Limits

Draft mode

Also on SandBase

Send your first request

2. Authentication

3. Queue

Submit a request

Fetch request status and result

4. Files

Hosted files

Uploading images

5. Schema

Input

seedinteger

draftboolean

imagestring

promptstring

draft_idstring

durationvalue

end_imagestring

resolutionstring

generate_audioboolean

Output

ByteDance OmniHuman 1.5 ↗

ByteDance OmniHuman 2.0 ↗

Seedance 2.0 Mini Image to Video ↗

ByteDance DreamActor 2.0 ↗

Seedance 2.0 Mini Reference to Video ↗

Seedance 2.0 Mini Text to Video ↗

`seed`integer

`draft`boolean

`image`string

`prompt`string

`draft_id`string

`duration`value

`end_image`string

`resolution`string

`generate_audio`boolean