PixMind Docs
Api referenceVideo ModelsKling V3 Motion Control

Kling V3 Motion Control

Transfer motion from a reference video to a character image through the PixMind API.

Transfer motion from a reference video to a character supplied as an image.

Provider

Kuaishou

Model ID

kling-v3-motion-control

Endpoint

POST /v1/generations

Model notes

  • This PixMind route is Motion Control, not the separate Kling 3.0 Turbo text-to-video route.
  • Billing uses the delivered video duration rounded up to whole seconds.

Request parameters

ParameterTypeRequiredDescription
modelstringYes

Stable PixMind model ID. Use `kling-v3-motion-control`.

Allowed values: kling-v3-motion-control

promptstringNo

Natural-language generation or editing instructions.

character_image_urlstring (URI)Yes

Character image whose appearance should be preserved.

motion_video_urlstring (URI)Yes

Reference video that supplies body and camera motion.

resolutionstringNo

Output video resolution. This field affects per-second pricing.

Allowed values: 720p, 1080p

Default: 720p

character_orientationstringNo

How character orientation follows the source motion.

Allowed values: image, video

Default: image

keep_original_soundbooleanNo

Keep audio from the motion reference video.

Allowed values: true, false

Default: false

callback_urlstring (URI)No

HTTPS endpoint that receives the terminal task event. Polling remains available when omitted.

Request example

cURL
curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v3-motion-control",
  "prompt": "Preserve the character identity and reproduce the full-body movement",
  "character_image_url": "https://example.com/character.png",
  "motion_video_url": "https://example.com/motion.mp4",
  "resolution": "720p",
  "character_orientation": "image",
  "keep_original_sound": false
}'
JavaScript
const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "kling-v3-motion-control",
  "prompt": "Preserve the character identity and reproduce the full-body movement",
  "character_image_url": "https://example.com/character.png",
  "motion_video_url": "https://example.com/motion.mp4",
  "resolution": "720p",
  "character_orientation": "image",
  "keep_original_sound": false
})
});

const task = await response.json();

Accepted task response

Generation is asynchronous. Save the id from the response and poll GET /v1/generations/{id} until it reaches a terminal status.

202 Accepted
{
  "id": "img_01JXYZ...",
  "model": "kling-v3-motion-control",
  "status": "processing"
}

API pricing

ConfigurationPrice
720p motion transfer$0.160 / second
1080p motion transfer$0.240 / second

API pricing uses the apiPlatform role and is separate from PixMind Studio credits. The accepted task response is the final pricing snapshot.