Video: Image-to-Video

sd-2-omni-reference (best)

Generate video with multiple modality references using Seedance 2 Omni (9 images + 3 videos + 3 audio). Input: multiple images/videos/audio, text prompt, with selectable resolution (480p/720p/1080p/4k, price scales accordingly). Output: video. Use for: multi-reference video synthesis.

post/api/v1/seedance-2.0-omni-reference

Request

  • Base URL: https://api.muapi.ai
  • URL: https://api.muapi.ai/api/v1/seedance-2.0-omni-reference
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (client credentials, token URL https://api.muapi.ai/oauth/token)

Query parameters

webhookstring
team_idinteger nullable

Headers

x-api-keystring
x-embed-codestring nullable
x-agent-embed-codestring nullable
x-whitelabel-studiostring nullable
authorizationstring nullable

Request body

promptstring required

Text prompt describing the video. Reference images with @image1…@imageN, videos with @video1…@videoN, and audio with @audio1…@audioN. To use a character sheet, reference it with @character:<request_id> (from a completed Seedance 2 Character generation) — appended as an image reference. 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'.

images_liststring[] nullable

Up to 9 reference images (JPEG/PNG/WebP). Referenced in prompt via @image1…@image9.

video_filesstring[] nullable

Up to 3 reference video clips (MP4, max 15s each). Referenced in prompt via @video1…@video3.

audio_filesstring[] nullable

Up to 3 reference audio files (MP3/WAV, total max 15s). Referenced in prompt via @audio1…@audio3.

webhook_urlstring uri nullable
aspect_ratio'21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16'
quality'high' | 'basic'
durationinteger
resolution'480p' | '720p' | '1080p' | '4k'

Output resolution. Price scales with resolution — see the model's pricing table.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.