Video: Edit & Effects

seedance-2.5-motion-control (balanced)

Seedance 2.5 version of Motion Control — recasts an existing performance video with new performers while preserving motion, choreography, blocking, camera work, and location. Input: video_url (required reference video), images_list (up to 30 character reference photos), optional prompt, duration (4-30s), seed. Output: 720p video. Use for: dance/choreography recasts, brand/UGC recreation, location-preserving performer swaps, multi-character (up to 30) recasts.

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

Request

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

webhook_urlstring uri nullable
durationinteger

Video duration in seconds, from 4 to 30.

aspect_ratio'adaptive' | '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9' | '9:21'
seedinteger nullable

Random seed for reproducible generation. Use -1 for random.

high_bitrateboolean
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 30 character/location/style reference images used to recast the performers and environment.

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.