Animate a character with a motion video
pixverse_motion_controlMake the person or animal in a character image move like the subject of a reference video (PixVerse motion control, v5.6); no prompt. The image must show a clear subject (422 otherwise). Both are paths from pixverse_upload_file. Uses PixVerse credits by the motion video's length. Waits up to ~50 s, then returns the video_id for pixverse_get_video. POST /videos/motion-control.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_path": "<image_path>",
"video_path": "<video_path>"
},
"name": "pixverse_motion_control"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| No | The PixVerse account email (pixverse_list_accounts). Optional: by default a random account with a free slot. | ||
| model | No | Default v5.6. | |
| maxJobs | No | Override the account's maxJobs (jobs at once) for this request, 1-8. | |
| quality | No | Video quality. | |
| image_path | Yes | The character image: a path from pixverse_upload_file. | |
| video_path | Yes | The motion reference video: a path from pixverse_upload_file. | |
| off_peak_mode | No | true runs it in Off-Peak mode at a lower credit cost (native PixVerse models; the discount depends on the plan). Such a job is not waited for: read it later with pixverse_get_video. |