Motion control with DreamActor M2.0
BytePlus DreamActor M2.0 — drives the character in an image to replicate the motion, facial expressions, and lip movements from a reference video, preserving the subject and background of the image. Works for real people, animation, and pets. 720p MP4 output. Priced per second of the reference video (50 credits/second).
Asynchronous. Returns a job id (the video is not in this response). Poll GET /v1/motion-control/{id} until status is succeeded — the video URL is in that response’s video_url.
Authorizations
API key as a bearer token: Authorization: Bearer bpx_live_xxx
Body
Character image to animate (the subject). A public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. jpg/png, max 4.7 MB; 480x480 to 1920x1080 (larger images are scaled down).
Motion reference video whose movement drives the character. A public video URL or an uploaded-file URL from POST /v1/uploads. mp4/webm, 3-30 seconds, up to 30 MB.
Trim the 1-second transition at the start of the output video.
Response
Job accepted.
Total price of this job (seconds x the model's per-second rate).
Opaque job id (mtn_...) — use it to poll status.
Billed duration — the reference video's length
Lifecycle state. succeeded/failed/timeout are terminal.
pending, starting, processing, completing, succeeded, failed, timeout