Seedance 2.5 API

Video·seedance-2.5·by Bytedance

Seedance 2.5 Reference-to-Video blends up to 50 image, video, and audio references into one consistent clip for character-true branded storytelling

Runtime (p50)
4m
Estimated price
From $1.15
Call the API
prediction.sh
sh
curl -X POST \
  -H "Authorization: Bearer $EACHLABS_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "bytedance-seedance-2-5-reference-to-video",
    "version": "0.0.1",
    "input": {
        "prompt": "Shot 1 (0–2s): @Image1 — The pasta bowl rotates smoothly on the table as steam rises and strands of spaghetti lift and twirl upward. The rotation accelerates into a fast spin and the frame blurs. Spin transition.\n\nShot 2 (2–4s): @Image2 — Out of the spin, same table and framing, the plate is now the seared fish, still rotating and slowing to a stop as golden olive oil pours down over the fillet. The plate spins up fast again and blurs. Spin transition.\n\nShot 3 (4–6s): @Image3 — Out of the spin, same table and framing, the bowl is now the salad, rotating and slowing as fresh leaves, walnuts and feta cubes tumble down into it. The bowl spins up fast again and blurs. Spin transition.\n\nShot 4 (6–8s): @Image4 — Out of the spin, same table and framing, the plate is now the chocolate lava cake, rotating and slowing to a full stop as the cake splits open and molten chocolate flows out across the plate. The camera pushes in slightly and holds on the final dish.\n\nStyle: cinematic food commercial, macro lens, shallow depth of field, warm restaurant ambient light, plates rotate on a turntable, motion blur during each spin, food details in slow motion, glossy oil and sauce highlights, identical table, background and framing across all four shots, fast energetic pacing on the beat.",
        "duration": "8",
        "image_urls": [
            "https://cdn-us.eachlabs.ai/defaults/255e7f019d314f67aa06ef79df8daa08.png",
            "https://cdn-us.eachlabs.ai/defaults/36868028afa94ec28f59332e3f30e2a5.png",
            "https://cdn-us.eachlabs.ai/defaults/4e7c27d4777f43a0bb9c103fc07acf71.png",
            "https://cdn-us.eachlabs.ai/defaults/8fd7d6ba603d4847b586966268aa0ebf.png"
        ],
        "resolution": "720p",
        "aspect_ratio": "9:16",
        "output_format": "mp4",
        "generate_audio": true
    },
    "webhook_url": ""
}' \
  https://api.eachlabs.ai/v1/prediction/
Documentation8 sections
  • Overview

    Bytedance | Seedance 2.5 | Reference to Video Overview

    Bytedance | Seedance 2.5 | Reference to Video is a multimodal video generation model that turns reference assets and prompts into a single coherent clip. It is designed for character-true storytelling, branded scenes, and controlled motion when consistency matters more than one-off novelty. According to ByteDance’s Seedance 2.5 launch materials, the model’s main differentiator is its ability to combine flexible referencing with a long native generation window and synchronized audio-video output in one pass.

    For each::labs users, Bytedance | Seedance 2.5 | Reference to Video is best understood as a production-oriented model rather than a simple clip generator. It supports reference-guided creative control for scenes that need identity consistency, camera direction, and stable visual style across the full shot.

  • Capabilities

    Capabilities

    • Generates a full video clip from reference assets and a text prompt in a single pass.
    • Blends multiple reference types, including image, video, and audio inputs.
    • Supports character-consistent branded storytelling across a longer continuous shot.
    • Produces synchronized audio-video output rather than silent motion only.
    • Handles multi-reference scene control for identity, style, and motion direction.
    • Supports extended generation up to 30 seconds per clip.
    • Is suited to reference-to-video workflows where asset fidelity matters more than abstract text creativity.
  • Use cases

    Use Cases for Bytedance | Seedance 2.5 | Reference to Video

    Creators can use Bytedance | Seedance 2.5 | Reference to Video to turn character sheets and voice cues into a consistent cinematic scene. Example prompt: “Keep the same protagonist identity from the references, add a slow push-in, and generate a dramatic night sequence with synced ambient audio.”

    Marketers can build brand-safe product clips by combining product photos, style references, and motion guidance. Example prompt: “Preserve the exact bottle shape and label from the reference images, then create a premium studio reveal with soft reflections and controlled camera movement.”

    Designers and developers can prototype concept videos from mood boards and motion references before committing to a larger production workflow. Example prompt: “Use these references to maintain the same environment design, then animate a clean walkthrough with natural lighting and consistent framing.”

    For editorial or branded storytelling, teams can keep costumes, props, and scene tone aligned across a longer shot. Example prompt: “Match the wardrobe and facial identity from the references, then stage a single continuous scene with subtle performance changes and synced audio.”

  • Tips & tricks

    Tips and Tricks

    Use concise prompts that define the subject, motion, environment, and camera behavior separately. Pair that with the most representative reference assets first, then add supporting references only if they reinforce the same identity or visual language. ByteDance’s Seedance 2.5 materials emphasize flexible referencing, so overloading the model with conflicting inputs is a common way to reduce consistency.

    For best results, describe the scene outcome rather than every visual detail. For example: “A confident product reveal in a premium studio, slow dolly-in, clean reflections, branded color palette.” Another useful format is: “A character walks through a rain-lit city street, keep face identity consistent across the full clip.” A third example is: “Use the reference images to preserve wardrobe and hairstyle, then animate the scene with subtle handheld camera motion.”

    When using the Bytedance | Seedance 2.5 | Reference to Video API, start with the minimum viable reference set, then expand only if the output drifts from your target. This usually improves control and makes iteration easier.

  • Technical spec

    Technical Specifications

    • Model type: reference-to-video, with multimodal audio-video generation.
    • Input modalities: text, image, video, and audio references can be combined in one generation.
    • Reference capacity: Seedance 2.5 is described as supporting up to 50 reference assets in launch coverage.
    • Clip length: up to 30 seconds per generation in a single pass.
    • Output: synchronized video and audio, with native audio-video generation.
    • Resolution: 480p and 720p are documented in technical reporting; some secondary sources claim higher-resolution variants, but those are less consistently confirmed.
    • Output format: video output is typically delivered as standard downloadable media via API workflows.
    • Architecture: ByteDance describes Seedance as a unified multimodal audio-video model, though detailed public architecture specs remain limited.
  • Things to be aware of

    Things to Be Aware Of

    Reference-heavy workflows can fail when the inputs conflict, are low quality, or are too visually different from one another. If the prompt asks for too many changes at once, the model may prioritize some references and ignore others.

    Users also make the mistake of treating Bytedance | Seedance 2.5 | Reference to Video like a pure text-to-video system. It is more effective when the references are intentional and the prompt tells the model what to preserve versus what to animate.

    Plan for iteration if your scene depends on exact identity matching, product labeling, or precise motion continuity. The Bytedance | Seedance 2.5 | Reference to Video API is best used with clear, clean inputs and a narrow creative target.

  • Key considerations

    Key Considerations

    Bytedance | Seedance 2.5 | Reference to Video is strongest when you already have reference material and want controlled continuity across a longer scene. It is a good fit for branded content, character consistency, and multi-reference scene building, especially when the final output must preserve identity, style, and motion direction.

    Because the model is reference-driven, quality depends heavily on reference clarity and relevance. The best results usually come from clean assets, specific prompting, and a clear creative objective. Compared with simpler generation workflows, Bytedance | Seedance 2.5 | Reference to Video trades some speed and simplicity for much higher control and stronger scene coherence.

  • Limitations

    Limitations

    Public documentation is still limited on exact API-side parameters, processing time, and all supported output variants. Some third-party sources also disagree on maximum resolution, so 4K claims should be treated carefully unless confirmed in the specific deployment you are using.

    Like other reference-to-video systems, it cannot guarantee perfect identity lock, exact frame-by-frame control, or flawless results when references are inconsistent. It is strongest for guided generation, not for exact deterministic animation.

Related models

4 models
* FAQ

About Seedance 2.5 API

01 / 05

What is Seedance 2.5 Reference-to-Video?

Seedance 2.5 Reference-to-Video is ByteDance's video generation model that creates new footage guided by assets you provide. A single request accepts up to 50 references, 30 images, 10 video clips, and 10 audio clips, so characters, products, motion, and sound can all come from your own material.