Kling v3 Motion Control

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "kling-v3-motion-control",
    "input": {
      "image": "https://example.com/input.webp",
      "video": "https://example.com/input.mp4"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

6 fields in input, required first.

• imageRequired
  URL

  Reference image. The characters, backgrounds, and other elements in the generated video are based on the reference image. Supports.jpg/.jpeg/.png, max 10MB, dimensions 340px-3850px, aspect ratio 1:2.5 to 2.5:1.

• videoRequired
  URL

  Reference video. The character actions in the generated video are consistent with the reference video. Supports.mp4/.mov, max 100MB, 3-30 seconds duration depending on character_orientation.

• promptOptional
  string

  Text prompt for video generation. You can add elements to the screen and achieve motion effects through prompt words.

• character_orientationOptional
  image, videoDefault image

  Orientation of the character in the generated video. 'image': same orientation as the person in the picture (max 10s video). 'video': consistent with the orientation of the characters in the video (max 30s video). When binding elements, only 'video' orientation is supported.

• modeOptional
  std, proDefault pro

  Video generation mode. 'std': Standard mode (720p, cost-effective). 'pro': Professional mode (1080p, higher quality).

• keep_original_soundOptional
  booleanDefault true

  Whether to keep the original sound of the reference video