Seedance 2.5 API

Introduction

Seedance 2.5 Image-to-Video starts with your still image and develops the action that follows. Use it to turn an approved composition into a product sequence, character performance or visual transition. A closing image can guide the ending when you have both ends of the shot planned.

The model comes from ByteDance's July 31, 2026 release.

Choose the starting point for your Seedance 2.5 sequence

Key features

Longer stories in a single generation

Seedance 2.5 supports clips up to 30 seconds, giving a sequence room for a setup, development and ending. Its storytelling capabilities include connected shots and scene transitions rather than simply extending one gesture.

Flexible multimodal references

Images, footage and audio can guide different elements of the same production. The expanded reference workflow supports more complex casts, settings and shot plans while separating appearance from movement and sound.

Clay-render and storyboard guidance

Rough 3D planning footage can communicate spatial structure, blocking and camera movement, while visual references supply the final look. Storyboards and ordered keyframes offer additional ways to convey a sequence.

More detailed visual and sound direction

The model's development emphasizes materials, lighting, skin and eye detail, along with coordinated audio and motion. Prompts can specify dialogue, effects and ambience separately, and use whole-second timestamps to organize events.

Targeted editing and continuation

The model family includes time-targeted video edits, background changes and continuation of existing footage. These are distinct video-input workflows; their availability and settings depend on the selected task, not on a text-to-video or image-to-video request.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 93 credits for a 5-second clip ($0.93).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Turn a campaign still into a small performance

Start with an authorized image of a subject holding or wearing the featured item. Request a gesture, a change of gaze and a final hold. Review facial details, hands and the product as the pose changes.

Animate the opening of a designed object

Use a still of a closed case or package, with a closing-frame image if a particular open view is required. Describe the order of movement and check hinges, edges and the final arrangement.

Give an architectural still an unfolding atmosphere

Begin with a composed room or exterior and request a restrained camera movement with a specific environmental change. Inspect straight lines, furniture placement and lighting continuity throughout.

Prompt guide & pro tips

How to direct movement from a first frame

Use the still for appearance and composition, and the prompt for the action that follows. Start with a short summary of the movement, then use consecutive time ranges when its development matters.

1. Upload the source image through image_url.
2. Prepare its framing before generation: this mode uses adaptive aspect ratio.
3. Choose duration_seconds and describe the movement across that duration.
4. Separate subject motion, camera motion and sound.

For a reading-room still with a curtain beside a window, choose 12 seconds:

Continue from the supplied reading-room image in one continuous shot.
A breeze lifts the curtain and then fades.

0-3s: The curtain hangs almost still. Keep the camera fixed.
3-8s: The lower edge lifts inward and drifts slowly away from the window. Gently move the camera toward the window.
8-12s: The fabric settles back down. Stop the camera and hold the composition.

Retain the furniture positions, window structure and existing light direction.
Sound: soft fabric movement and distant outdoor ambience.
No speech, background music or captions.

How to connect first and last frames

Supply the opening image as image_url and the closing image as last_image_url. Prepare both with the same aspect ratio; mismatched framing can distort the closing composition.

Describe the bridge between the images, not just the destination. For a closed box becoming an open box, specify that the lid rises while the base stays in place. Assign time for both the movement and the final hold.

Adjust the prompt when the action feels rushed

Use continuous ranges such as 0–3s, 3–8s, 8–12s; gaps leave the sequence underspecified. If the middle contains several competing actions, simplify it or allocate more time. Keep the endpoint's duration setting consistent with the final timestamp.

Preserve the image without repeating it

State the few details that matter most, such as the product shape or room layout. Avoid redescribing every visible object or introducing a conflicting art style. For sound, distinguish room ambience, action sounds and music so the requested movement has an appropriate soundtrack.

API quick start

Call the Seedance 2.5 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model bytedance/seedance-2.5/image-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.5/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Seedance 2.5 API questions

All Seedance models

Seedance 2.0 reaches 4K but stops at 15 seconds, and costs less per second. Seedance 2.5 runs up to 30 seconds per take and takes the largest reference sets.

• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Seedance 2.0 Mini APILightweight Seedance for quick 720p drafts with soundFrom 9 credits for a 5-second clip
• Seedance 2.0 APICinematic clips up to 4K with native audioFrom 33 credits for a 5-second clip
• Seedance 2.0 Fast APIFaster Seedance 2.0 with sound at 720pFrom 17 credits for a 5-second clip
• Seedance 1.5 Pro APINative-audio clips with an optional locked cameraFrom 9 credits for a 5-second clip

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip

More about Seedance 2.5

Try it

Seedance 2.5 AI Video Generator onlineCreate videos with Seedance 2.5 in PopNow

Compare

Kling 3.0 vs Seedance 2.5Seedance 2.5 vs Wan 3.0Seedance 2.0 vs Seedance 2.5

Docs

Seedance 2.5 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Seedance 2.5 results without polling