Seedance 2.0 Mini Reference to Video API

The most affordable Seedance 2.0 reference-to-video tier from ByteDance. POST to /api/v1/videos/generations with model: seedance-2-0-mini-refs, a prompt, and up to 9 images, 3 videos and 3 audio clips that you cite as @image1, @video1 and @audio1. The response returns an img_uuid to poll or receive by callback.
Get API Key
Director's desk with printed reference photos, a small monitor and a microphone arranged around a clapperboard

Three Kinds of Reference in One Prompt

Tag every reference in the prompt

Each array is numbered from 1 in its own order: ref_imgs become @image1…@image9, ref_videos become @video1…, ref_audios become @audio1…. Example: "Use the camera movement of @video1 and keep the product in @image1".
Three labeled-free index cards connected by colored threads on a cork board

Borrow camera motion from a clip

Up to 3 ref_videos in mp4 or mov, 2 to 15 seconds each and 15 seconds in total, act as camera or motion reference or as an editing source. Reference footage is billed together with the output, so read the pricing notes below.
Camera on a slider rail moving past a product on a turntable

Sound included at no extra charge

generate_audio defaults to true and adds a synchronized soundtrack for free. Add up to 3 ref_audios (wav or mp3, 2 to 15 seconds each, 15 seconds total) for music, effects or voice; they need at least one image or video alongside.
Small speaker and headphones beside a laptop playing a video in a dim edit suite
Only model and prompt are required; references, length and format are optional.

Seedance 2.0 Mini Reference to Video Request Fields and Limits

model and prompt (required)

model is seedance-2-0-mini-refs. Keep the prompt within about 1000 English words (or 500 Chinese characters).

ref_imgs

Up to 9 jpeg, png or webp images, each up to 30 MB, 300 to 6000 px, aspect ratio 0.4 to 2.5.

ref_videos

Up to 3 mp4 or mov clips, 2 to 15 seconds each, 15 seconds total, up to 50 MB each. Using this field changes the billing formula.

ref_audios

Up to 3 wav or mp3 clips, 2 to 15 seconds each, 15 seconds total, up to 15 MB each. Requires at least one image or video reference.

duration and quality

duration is any integer from 4 to 15 seconds (default 5). quality is 480p or 720p (default 720p); resolution is accepted as an alias.

aspect_ratio, audio and callback

aspect_ratio (alias ratio): 16:9 (default), 9:16, 1:1, 4:3, 3:4, 21:9 or adaptive. generate_audio defaults to true. callback_url (alias custom_callback_url) is an optional public HTTPS URL.
Per second of generated video by resolution, with a separate formula when reference videos are attached.

Seedance 2.0 Mini Reference to Video API Pricing

480p: 2.99 tokens ($0.0598) per second

A 5-second 480p clip with image references only costs 14.95 tokens ($0.299).

720p: 6.44 tokens ($0.1288) per second

A 5-second 720p clip with image references only costs 32.2 tokens ($0.644). Generated audio adds nothing.

With ref_videos: (input + output seconds) × rate × 0.8

Reference footage is billed at the output rate and the total gets a 20% discount. A 6-second reference video with a 5-second 480p output is 11 × 2.99 × 0.8 = 26.312 tokens ($0.52624).

Charged on acceptance, refunded on failure

Input length is measured before tokens are deducted. The submit response returns the actual cost, and failed generations are refunded automatically.

Integrate the Seedance 2.0 Mini Reference to Video API

1

1. Create an API key

Generate a key at /keys and send it as Authorization: Bearer <key> from your backend.
2

2. Host and order the references

Upload images, videos and audio to public URLs. The order inside each array decides which @imageN, @videoN or @audioN tag points to it.
3

3. Submit and store img_uuid

POST the JSON body to https://api.goenhance.ai/api/v1/videos/generations and save the returned img_uuid and cost.
4

4. Poll or receive the callback

Call GET /api/v1/jobs/detail until status is success, then download the video from json[].value before link_expired_at, 24 hours after the job finishes.
Create an API Key
Low-cost reference-driven clips where consistency matters more than resolution.

What Developers Build with Seedance 2.0 Mini Reference to Video

Product clips from catalog photos

Keep a product from @image1 on screen while borrowing a camera move from an existing reference clip.

Drafts before a higher tier

Iterate on prompts and reference sets at 480p before committing the final version to a more expensive model.

Music-led social shorts

Pair character or scene images with a short ref_audios track to produce vertical 9:16 clips with sound.

Template-based video at scale

Swap the images in a fixed prompt template to generate many consistent variants for marketplaces or ads.
References, limits, billing and results.

Seedance 2.0 Mini Reference to Video API FAQ

What is the endpoint?

POST https://api.goenhance.ai/api/v1/videos/generations with model: seedance-2-0-mini-refs and a prompt.

How do I refer to my images, videos and audio?

Write @image1, @video1 or @audio1 in the prompt; the number is the item's position in its own array, starting at 1.

Why did a request with a reference video cost more?

With ref_videos, the charge is (total input video seconds + output seconds) × rate × 0.8. Requests with only images are billed on output length alone.

What resolutions and lengths are available?

480p or 720p, any whole number of seconds from 4 to 15, in 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 or adaptive.

Does generated audio cost extra?

No. generate_audio is on by default and is included in the per-second price.

How long are result links valid?

Result URLs expire 24 hours after the job finishes, as shown in link_expired_at. Download and store the file yourself.

Start Building with the Seedance 2.0 Mini Reference to Video API