HiAPI
21:9 cinematic widescreen hero image: soft, diffused open space on the left; on the right, a translucent glass film strip and floating glass frames unfurl in a winding path, with an iridescent gradient of ice blue, blush pink, and lavender; the glowing three-dimensional text "seedance-2.5-flash" is etched onto the largest frame of the film strip, serving as the header image for the seedance-2.5-flash/image-to-video detail page.

ByteDance

Seedance 2.5 Flash

seedance-2.5-flash/reference-to-video

The ByteDance Seedance 2.5 series video model supports text-to-video, first-frame-based generation, and multimodal reference generation, producing 4 to 30 seconds per output with a choice of 480p or 720p and synchronized audio, making it ideal for rapidly producing short advertising clips and e-commerce product videos

Try seedance-2.5-flash/reference-to-video

Input

Output

video
Fill in the parameters and run — results show up here.

Pricing

seedance-2.5-flash/reference-to-video per second

Specifications Unit Price
480P $0.0679
720P $0.1525

Overview

For developers who need to drive video creation with reference assets: enter a prompt and reference images or audio in order to generate a video with continuous imagery. You can choose 480p or 720p resolution, aspect ratio, a duration of 4 to 30 seconds, and mp4 or mov output as needed. It suits scenarios such as ad clips, product showcases, and social short videos that need to carry over the style of existing assets.

Key Highlights

  • Multi-asset reference-driven generation — reference up to 10 images and 5 audio clips, naming them in order in the prompt as @image1, @audio1, and so on.
  • Images define the visuals, audio defines the rhythm — reference images constrain the appearance of people, products, and scenes, while reference audio provides music, beats, or voiceover; the two can be used separately or together.
  • Flexible duration and aspect ratio — duration can be selected from 4 to 30 seconds in one-second increments, and aspect ratios cover landscape, portrait, square, and widescreen, or can adapt to the reference assets.
  • Output suits post-production workflows — in addition to the more compatible mp4, you can also choose mov format for professional post-production.

Capability Details

Reference images constrain visual content: you can submit up to 10 reference images in jpeg, png, webp, bmp, tiff, and gif, with each image no larger than 30MB and 300 to 6000 pixels per side; reference them in the prompt as @image1, etc.

Set duration as needed: duration can be an integer from 4 to 30 seconds, or -1 to let the model decide automatically based on the content; billing is by the number of seconds in the final video.

Audio references assist generation: you can submit up to 5 reference audio clips in wav or mp3, each 2 to 30 seconds and no larger than 15MB, totaling no more than 30 seconds; audio can also be used alone without reference images.

Aspect ratio, resolution, and format settings: output resolution can be 480p or 720p; aspect ratios support 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, and adaptive; output can be mp4 or mov.

Use Cases

  • Short-video production for brand and advertising teams — use existing product images and brand music as references to generate continuous shots with an opening, camera movement, and ending, for comparing creative versions before launch.
  • E-commerce product showcase shots — input multiple product images and name them one by one in the prompt to generate showcase or usage-scene videos for product detail pages or feed ads.
  • Vertical short videos for social platforms — choose a 9:16 or 1:1 aspect ratio and use image and audio references to generate short videos for daily content updates on short-video platforms and social media.
  • Music or voiceover short videos — submit images of people or products plus a reference audio clip so that on-screen action follows the audio rhythm, for showcase videos with music or voiceover short videos.

Limitations and Selection Advice

At most 10 reference images and at most 5 reference audio clips totaling no more than 30 seconds; anything beyond that must be split into multiple generations. Output resolution is limited to 480p and 720p, and aspect ratios do not include ultra-wide or custom ratios. A single generation lasts at most 30 seconds; longer content must be generated in segments and edited together. Reference assets are subject to format, size, and pixel-range limits; files that do not meet the requirements cannot be submitted.

ByteDance reference-driven video model

Drive continuous video generation with reference assets

Submit a prompt along with image or audio references, and the model understands the assets in the order they are referenced to generate a video clip with coherent imagery. Output supports 480p and 720p, multiple aspect ratios, and mp4 or mov format.

  • Output typeVideo
  • Resolution480p / 720p
  • Duration4–30 seconds, or -1 for auto
  • Reference assetsUp to 10 images / 5 audio clips

Name assets in the prompt in the order @image1, @audio1, and state clearly what role each asset plays.

01

Capabilities

How it performs: three verifiable capabilities

The three capabilities below correspond to image references, audio references, and output specifications; you can check the input limits for each before organizing your prompt.

Image references establish the visual foundation

Upload up to 10 images as content references, covering common bitmap formats with limits on individual file size and pixel range. Reference them in order in the prompt as @image1, etc., so you can specify which image corresponds to which subject or scene. The key check is that reference numbers match the order of assets.

Audio references guide generation

You can submit up to 5 audio clips in wav or mp3, each 2 to 30 seconds and totaling no more than 30 seconds. Audio can be used alone or combined with images, referenced in the prompt as @audio1. The key check is that each clip's size and duration are within limits.

Output specifications and format selection

Choose resolution between 480p and 720p; aspect ratios cover landscape, portrait, square, and widescreen, or can be set to adaptive to follow the assets. Output format can be the more compatible mp4 or post-production-oriented mov. When checking, confirm the aspect ratio matches the distribution channel.

The number, format, and duration of reference assets determine the range you can submit, and the order of references in the prompt determines how the assets participate in building the visuals.

02

Getting started

From reference assets to a video clip

Try it →

Start by clarifying the purpose, prepare compliant reference assets, then organize a prompt with reference numbers, and finally check the final video against the output specifications.

  • Reference imagesjpeg/png/webp/bmp/tiff/gif, each ≤30MB
  • Reference audiowav/mp3, 2–30 seconds, total ≤30 seconds

A set of reference assets that meet the limits

01

Prepare reference assets

First determine whether you need image or audio references, and filter files according to their respective format, size, pixel, and duration requirements to avoid uploading unsupported types.

  • PromptUp to 5000 characters, reference assets in order

A prompt that maps assets to instructions

02

Write a prompt with references

Name assets in order using @image1, @audio1, and describe the visual content and actions, as well as which part of the audio the visuals should sync to.

Duration4–30 seconds, or -1 for auto

✓Verify

→

Aspect ratio16:9, 9:16, 1:1, etc., or adaptive

03

Set output parameters and verify

Choose duration, resolution, aspect ratio, and output format, then check that the number of reference assets and the total audio duration are within limits.

03

Scenarios

Where to use it: three typical short videos

Comparing creative versions of ad short videos

Use product images and brand music as references to generate continuous shots that include camera movement and an action ending. Suitable for preparing multiple creative directions before launch; the key check is whether the product appearance from the reference assets stays consistent on screen.

Product showcases for e-commerce detail pages

Submit multiple product images and reference each one in the prompt to generate showcase or usage-scene videos. The final video can go directly into product detail pages or feed ads; the key check is whether the subject is clearly recognizable in the shot.

Voiceover or music short videos with reference images plus audio

Use reference images to define the person or product and reference audio to define the rhythm or voiceover, generating a short video whose visuals advance along with the audio. Suitable for voiceover introductions and showcase videos with music; the key check is whether the action syncs with the audio beat.

04

Integration

Integration: call seedance-2.5-flash in your product or AI tool

A single HiAPI API Key is all you need; all methods share the same account and billing.

  1. Create an API Key

    Go to console →

  2. Choose an integration method

    Pick any one on the right and copy it

  • AI coding tools Recommended

    Connect via MCP with commands for Claude Code, Cursor, Codex, etc.

  • Direct API

    Your own product, backend services, automation workflows

  • Not sure which to choose

    Copy a message to an AI and let it choose for you and give the steps

Agent Skills · SDK · llms.txt · All integration methods →

Terminal · Claude Code

claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Once connected, just tell the AI your goal and let it call seedance-2.5-flash, check task progress, and get results. Configuration steps for Cursor, Codex, and other tools are in the tutorial below.

View the Agent integration tutorial →

Integrate into your product via API

Use the API Key to submit tasks for the current model and query status by the returned task ID. The request parameters use the same route data as the API documentation on this page; replace the input content in the examples with your actual assets.

# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5-flash/reference-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "480p",
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "generate_audio": true,
    "omni_reference_task_type": "reference"
  }
}'
View the full API documentation on this page →

Let AI help you choose an integration method

Please read the HiAPI documentation index at https://hiapi.ai/llms.txt. I want to use seedance-2.5-flash in my project. First, based on my usage scenario, determine whether Remote MCP, Agent Skills, or the direct API is more suitable; if necessary, ask me one key question first, then give the simplest integration steps and the configuration to fill in.

Copy this message to the AI tool you use, and then add your project language, input assets, and expected results. It can use that to explain the integration method and next steps.

  • New model seedance-2.5-flash/reference-to-video is live
  • New model seedance-2.5-flash/image-to-video is live
  • New model seedance-2.5-flash/text-to-video is live

Frequently asked questions

View all FAQs →
  • What is the maximum length of a video that can be generated from an image?

    A single generation can be set to a maximum of 30 seconds, a minimum of 4 seconds, and defaults to 5 seconds. The duration field directly determines the length and is also billed by the requested duration; for longer finished videos, you can only generate segments and stitch them together.

  • What format and size requirements apply to the first-frame image?

    Supported formats are jpeg, png, webp, bmp, tiff, gif, heic, and heif, with a maximum of 30 MB per image, 300 to 6000 pixels per side, and an aspect ratio of 0.4 to 2.5. Images outside these ranges will fail outright, so it is recommended to resize and transcode them before uploading.

  • Which resolutions and aspect ratios are supported?

    There are two resolutions, 480p and 720p, with 480p as the default. Text-to-video and reference-to-video accept 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, or adaptive to let the model decide. Image-to-video is always adaptive and follows the first frame, so upload a portrait first frame if you want 9:16. This model does not offer 1080p.

  • What are the requirements for uploaded images and audio?

    For image-to-video, first and last frames can be jpeg, png, webp, bmp, tiff, gif, heic or heif, under 30 MB, 300 to 6000 pixels per side, with an aspect ratio between 0.4 and 2.5. A last frame with a different ratio is center-cropped to match. Reference-to-video takes up to 10 reference images in the same formats except heic, heif and svg, and up to 5 audio clips in wav or mp3, each under 15 MB and 2 to 30 seconds, 30 seconds combined. Audio can be used without any image.

Related Models

View all models →

Same Type