>docs/api/motion-control

Motion Control

Transfer motion from a reference video onto a character from a reference image using nohuman-x33. Motion control is one mode of the unified /v1/videos/generate endpoint — when you supply both image_url (character) and video_url (motion reference), the request is routed to the motion-control pipeline automatically. The model produces a new video where the character performs the actions from the source video.

# Endpoint

POST/v1/videos/generate

Same endpoint as Text-to-Video and Image-to-Video. Provide both image_url and video_url to invoke motion control.

Parameters

Name	Type	Required	Description
`image_url`	string	required	Publicly accessible URL to the character reference image. Required for motion control.
`video_url`	string	required	Publicly accessible URL to the motion reference video (3-30s). Required for motion control.
`prompt`	string	optional	Optional additional scene description to guide the generation.
`negative_prompt`	string	optional	Describe what you do not want in the video (e.g., "blurry, low quality").
`character_orientation`	string	optional ("image")	Character orientation source. "image" uses the image orientation, "video" uses the video orientation.
`keep_original_sound`	boolean	optional (true)	Keep the audio from the motion reference video in the output.
`duration`	number	optional (5)	Video duration in seconds. Options: 5, 10.
`mode`	string	optional ("fast")	"fast" or "hq".

Response

{
  "id": "gen_mc_x7y8z9",
  "model": "nohuman-x33",
  "status": "created",
  "poll_url": "/v1/videos/generations/gen_mc_x7y8z9"
}

# Code Examples

Motion Control Generation

curl -X POST https:"code-comment">//api.nohuman.studio/v1/videos/generate \
  -H "Authorization: Bearer $NOHUMAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/character.jpg",
    "video_url": "https://example.com/dance_reference.mp4",
    "prompt": "Person dancing in a studio with dramatic lighting",
    "duration": 5,
    "keep_original_sound": true
  }'

# Pricing

Duration	Fast	HQ
5s	$0.63	$0.84
10s	$1.26	$1.68

SYS :: videos/generate :: motion-control mode