muapi Logomuapi Logo
muapi Logomuapi Logo

Seedance 2 Omni Reference: Image-to-Video

Generate Seedance 2 Omni Reference videos from image, video, and audio references with consistent characters and style. Try free in Muapi — pay per generation.

Interactive model controls

SD 2.0 Omni Reference — generate videos with visual consistency using reference images, videos, and audio. Maintain character identity, style, and scene continuity. Supports up to 9 images, 3 video clips, and 3 audio clips. Use @image1, @video1, @audio1 syntax in your prompt. Selectable output resolution (480p/720p/1080p/4k) — price scales with the resolution chosen.

📝

Overview

About this model

SD 2.0 Omni Reference generates videos with visual consistency using reference images, videos, and audio. Unlike standard Image-to-Video which animates a single image, Omni Reference uses your uploaded materials as creative guides — maintaining character identity, visual style, and scene continuity. Combine up to 9 images, 3 video clips, and 3 audio files in a single request. Use @image1, @video1, @audio1 syntax in your prompt to precisely control how each reference influences the generated video. A selectable resolution field (480p/720p/1080p/4K) lets you trade off cost against fidelity — price scales with the resolution chosen.

1Character Consistency: Keep a character's appearance consistent across multiple scenes by providing a portrait as @image1.
2Style Transfer: Apply the visual style of a reference image to a newly generated video scene.
3Audio-Synced Video: Generate video synchronized to a reference music clip or voice recording via @audio1.
4Scene Continuity: Provide a scene screenshot and generate a visually matching continuation.
5Multi-Modal Control: Combine a character image + a motion video + background audio for rich creative control.
💰

Pricing & Value

Cost analysis

muapiapp$0.18–$1.35/sec depending on resolution/quality

Per-second billing, scaling by resolution and quality (480p: $0.18/sec basic, $0.24/sec high; 720p: $0.21/sec basic, $0.30/sec high; 1080p: $0.4725/sec basic, $0.675/sec high; 4K: $0.945/sec basic, $1.35/sec high). Supports multi-modal references (image + video + audio) in a single request.

Fal.ai$0.3024/sec (high) / $0.2419/sec (basic)

Fal.ai charges $0.3024/sec for high quality and $0.2419/sec for basic. muapiapp is roughly the same on high ($0.30/sec) and 13% cheaper on basic ($0.21/sec).

Replicate$0.3024/sec (high) / $0.2419/sec (basic)

Replicate charges the same as Fal.ai — $0.3024/sec (high), $0.2419/sec (basic). muapiapp is competitive on high quality and 13% cheaper on basic.

** Competitor pricing is estimated based on similar model architectures and usage tiers.

⚙️

Technical Details

Configuration schema

Promptstring

Video description. Use @image1…@image9 to reference images, @video1…@video3 for videos, @audio1…@audio3 for audio. To use a character sheet, reference it with @character:<request_id> (from a completed Seedance 2 Character generation). To use a trained Omni Reference character, reference it with @omni-character:<character_id> where character_id is the value returned by Omni Reference Train Character (e.g. char_1775422630065_4vbana). Both methods can be combined in the same prompt. Multiple characters are supported. Example: '@omni-character:char_1775422630065_4vbana walking through a neon-lit city at night'.

Default Value@image1 is the main character reference. A person walking on the beach at sunset, cinematic lighting
ResolutionEnum (4 options)

Output resolution. Choose 480p, 720p, 1080p, or 4k; price scales with the resolution chosen.

Default Value720p
Image URLsarray

Up to 9 reference image URLs (JPEG/PNG/WebP). Each Nth image corresponds to @imageN in the prompt.

Default Valuehttps://d3adwkbyhxyrtq.cloudfront.net/webassets/videomodels/seedance-v2.0-omni-reference.png
Video Reference URLsarray

Up to 3 reference video clip URLs (MP4, max 15s each). Each Nth video corresponds to @videoN in the prompt.

Default Valueundefined
Audio Reference URLsarray

Up to 3 reference audio clip URLs (MP3/WAV, total max 15s). Each Nth audio corresponds to @audioN in the prompt.

Default Valueundefined
Aspect RatioEnum (6 options)

Output video aspect ratio.

Default Value16:9
QualityEnum (2 options)

Generation quality. 'high' uses the standard model ($0.30/sec output + $0.09/sec per input video second). 'basic' uses the fast model (~2x speed, $0.21/sec output + $0.063/sec per input video second). Video reference inputs incur an additional 30% surcharge based on their combined duration.

Default Valuehigh
Duration (seconds)int

Video duration in seconds (4–15).

Default Value5
📖

Implementation Guide

Developer documentation

  1. Upload reference images (JPEG/PNG/WebP) as 'images_list' — up to 9 images.
  2. Optionally upload video clips (MP4, max 15s each) as 'video_files' — up to 3 videos.
  3. Optionally upload audio files (MP3/WAV) as 'audio_files' — up to 3 files, total max 15s.
  4. Write a prompt describing the scene. Reference files with @image1…@image9 for images, @video1…@video3 for videos, @audio1…@audio3 for audio.
  5. Choose resolution — 480p for cheaper drafts, 720p (default) for standard quality, 1080p for full HD, or 4k for the highest output tier — and set duration (4–15s) and aspect ratio.
curl -X POST https://api.muapi.ai/api/v1/seedance-2.0-omni-reference \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "@image1 is the main character walking through a neon-lit city",
    "images_list": ["https://example.com/character.jpg"],
    "resolution": "1080p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
  1. Poll or use webhook to retrieve the completed video.
❓

Common Questions

Frequently asked

How is Omni Reference different from Image-to-Video?

Image-to-Video uses your image as a literal first frame and animates it. Omni Reference uses images, videos, and audio as creative guides — the model generates a new scene that visually matches your references without using them as literal frames. It also supports video and audio references, which Image-to-Video does not.

How do I reference my uploaded files in the prompt?

Use @image1, @image2, etc. to reference images by position in images_list. Use @video1, @video2 for videos by position in video_files. Use @audio1, @audio2 for audio files by position in audio_files. If you don't use @ syntax, the first reference is automatically used as the primary reference.

Do I need to provide all types of references?

No. All reference arrays are optional. You can provide just images, just a video, just audio, or any combination. A text-only prompt is also valid.

What file formats are supported?

Images: JPEG, PNG, or WebP (up to 9). Videos: MP4 only, max 15 seconds each (up to 3). Audio: MP3, WAV, or other common formats, total max 15 seconds (up to 3 files). All URLs must be publicly accessible.

How is cost calculated?

Cost = (rate × output_duration) + (0.3 × rate × total_input_video_duration). Per-second output rates are: 480p — $0.18 basic / $0.24 high; 720p — $0.21 basic / $0.30 high; 1080p — $0.4725 basic / $0.675 high; 4K — $0.945 basic / $1.35 high. If video_files are provided, an additional 30% surcharge applies per second of combined input video duration. Example: 5s output (720p, high) + two 5s input videos = 5×$0.30 + 10×$0.09 = $1.50 + $0.90 = $2.40.

What is the difference between 'high' and 'basic' quality?

'high' uses the standard model for best quality output. 'basic' uses the fast model which generates at approximately 2x speed with slightly reduced quality — ideal for quick iterations and previews. Existing requests without a quality field default to 'high'.

What aspect ratios are supported?

16:9, 9:16, 1:1, 4:3, 3:4, and 21:9. Default is 16:9.

Can I choose a lower resolution to save cost?

Yes. The `resolution` field accepts `480p` ($0.18/sec basic, $0.24/sec high), `720p` (default: $0.21/sec basic, $0.30/sec high), `1080p` ($0.4725/sec basic, $0.675/sec high), or `4k` ($0.945/sec basic, $1.35/sec high). Price scales with the resolution chosen, in addition to the quality tier.