seedance-2.0-mini/reference-to-video

Key Features

• Multimodal reference inputs — combine up to 12 reference files (9 images + 3 videos + 3 audio clips) to orchestrate a unified video.
• @ mention syntax in prompts — use @image1, @video1, @audio1 tags to assign each reference asset a specific role with '= instruction' format.
• Style transfer & character consistency — preserves facial features, clothing, and artistic style across frames and scenes without drift.
• Motion transfer — extracts choreography, action sequences, and camera movement from reference videos and applies them to new scenes.
• Audio lip-sync — audio-driven mouth synchronization supporting 8+ languages.
• Most affordable option — lowest cost per clip while retaining reference-to-video orchestration capabilities at 480p and 720p.

Parameters

How to Use

1. Upload reference assets — images define appearance/style, videos define motion/camera, audio drives lip-sync/rhythm.
2. Write a prompt — describe the scene first, then use @image1 = instruction, @video1 = instruction to tell the model what to do with each asset (e.g. keep face, copy choreography).
3. Choose parameters — duration (4-15s), resolution (480p or 720p), aspect ratio, and camera movement.
4. Generate — submit and wait, then download the finished video with synchronized audio.
5. Iterate — take advantage of the lowest cost to experiment with different reference combinations.

Code Examples

import os
import requests

response = requests.post(
    "https://aircube.ai/api/v3/seedance-2.0-mini/reference-to-video",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "A woman walks through a neon-lit alley at night, moody cinematic atmosphere.\n@image1 = her: keep the exact face and outfit, she walks through the alley\n@audio1 = use as the ambient background soundtrack",
    "image_urls": [
        "https://example.com/character.jpg"
    ],
    "audio_urls": [
        "https://example.com/ambient.mp3"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
},
    timeout=300,
)
data = response.json()

if data["success"]:
    print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
    print("Error:", data["error"]["message"])

Pricing

Billing rules

• 480p / 4s: $0.14.
• 720p / 4s: $0.38.
• Longer durations scale proportionally.
• Failed generations are not charged.

Best Use Cases

• Style transfer — apply a reference image's artistic style to generated video.
• Action / choreography cloning — extract motion from a reference video and apply it to new characters or scenes.
• Lip-sync — audio-driven mouth synchronization in 8+ languages.
• Multi-scene narrative — combine multiple references to maintain character, scene, and camera continuity across cuts.
• Budget-friendly prototyping — explore creative ideas at the lowest cost before upgrading to Fast or standard quality.

Pro Tips

• With 1-2 images the model uses keyframe mode (faster); with 3+ assets or any video it switches to reference mode.
• Use the '@asset = instruction' format to assign each asset a clear role — e.g. '@image1 = her: keep the exact face and outfit, she is the lead dancer'.
• Use one primary camera instruction per prompt; add 'slow', 'smooth', or 'gentle' to control pacing.
• Audio references must be paired with at least one image or video.
• Use Mini for cost-effective exploration, then upgrade to Fast or standard Seedance 2.0 for higher resolution output.

Notes

• Maximum 12 reference files per request (9 images + 3 videos + 3 audio clips).
• Total audio duration ≤15 seconds, each audio file ≤15MB.
• Available resolutions: 480p and 720p only (use standard Seedance 2.0 for 1080p/4K).
• Native audio generation is enabled by default.
• Duration range: 4-15 seconds (continuous selection).