---
title: "sd-2-omni-reference (best)"
method: POST
path: "/api/v1/seedance-2.0-omni-reference"
tags: ["Video: Image-to-Video"]
---

# sd-2-omni-reference (best)

`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`)

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.

## Query parameters

- `webhook` string
- `team_id` integer, nullable

## Headers

- `x-api-key` string
- `x-embed-code` string, nullable
- `x-agent-embed-code` string, nullable
- `x-whitelabel-studio` string, nullable
- `authorization` string, nullable

## Request body

- Seedance2OmniReferenceBaseRequest: Used by the real base API endpoint and its standard workflow node to add the selectable `resolution` param — see Seedance2T2VBaseRequest above.
  - `prompt` string, 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_list` string[], nullable: Up to 9 reference images (JPEG/PNG/WebP). Referenced in prompt via @image1…@image9.
  - `video_files` string[], nullable: Up to 3 reference video clips (MP4, max 15s each). Referenced in prompt via @video1…@video3.
  - `audio_files` string[], nullable: Up to 3 reference audio files (MP3/WAV, total max 15s). Referenced in prompt via @audio1…@audio3.
  - `webhook_url` string, uri, nullable
  - `aspect_ratio` '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16'
  - `quality` 'high' | 'basic'
  - `duration` integer
  - `resolution` '480p' | '720p' | '1080p' | '4k': Output resolution. Price scales with resolution — see the model's pricing table.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/muapi/apis/muapi-api.md) · [All operations](https://skmtc.dev/muapi/apis/muapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muapi/apis/muapi-api/revisions/e4b7374381e5?raw)