Skip to main content
POST
Motion control with DreamActor M2.0

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
image
string
required

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

video
string
required

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_intro
boolean
default:true

Trim the 1-second transition at the start of the output video.

Response

Job accepted.

credits
integer

Total price of this job (seconds x the model's per-second rate).

id
string

Opaque job id (mtn_...) — use it to poll status.

message
string
model
string
seconds
integer

Billed duration — the reference video's length

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout