Video: Edit & Effects

seedance-2-motion-control (balanced)

Recast an existing performance video with new performers while preserving the source clip's motion, choreography, blocking, and camera work, and keeping the original location intact. Input: video_url (required reference video), images_list (up to 9 character reference photos), optional prompt, aspect_ratio, quality (high/basic), duration (4-15s). Output: video. Use for: dance/choreography recasts, brand/UGC recreation, location-preserving performer swaps.

post/api/v1/seedance-2-motion-control

Request

  • Base URL: https://api.muapi.ai
  • URL: https://api.muapi.ai/api/v1/seedance-2-motion-control
  • 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 nullable

Optional short creative brief describing the recast, e.g. 'swap the two dancers with the people in the reference images, keep the same room'. If omitted, the identities/roles are inferred automatically from the reference video and images.

video_urlstring uri required

Reference video whose motion, choreography, blocking, and camera work will be preserved.

images_liststring[] nullable

Up to 9 character/location/style reference images used to recast the performers and environment.

webhook_urlstring uri nullable
aspect_ratio'21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16'
quality'high' | 'basic'
durationinteger
generate_audioboolean

Generate audio (music/SFX) for the recast video. Off by default — a motion-control recast usually shouldn't have fabricated audio layered over the preserved performance.

Response

Successful Response

unknown required

Changes

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