Skip to main content
POST
Submit Kling 2.6 Motion Control Task
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Transfer motion from reference videos to character images with precise motion control. Create dynamic character animations by combining static images with motion reference videos while controlling scene details through text prompts.

Models

  • kling-2.6-motion-control - Motion transfer from video to character image

Features

  • Motion Transfer: Transfer real human motion, gestures, and expressions from reference videos to character images
  • Character Animation: Animate static characters with dynamic motion patterns
  • Character Orientation Control: Choose between matching image orientation (max 10s output) or video orientation (max 30s output)
  • Scene Control: Control scene details and environment through optional text prompts
  • Flexible Resolution: Choose between 720p (standard) or 1080p (high quality) output

Required parameters

  • image_urls: Single character image showing the subject’s head, shoulders, and torso
  • video_urls: Single reference video (3-30 seconds) for motion transfer
  • character_orientation:
    • "image" - Matches the person’s orientation in the photograph (maximum 10-second output)
    • "video" - Maintains consistency with character orientation from the reference video (maximum 30-second output)
  • resolution: Output resolution ("720p" or "1080p")

Optional parameters

  • prompt: Text description of the desired output scene (max 2,500 characters)

Authorizations

Authorization
string
header
required

All API endpoints require Bearer Token authentication.

Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.

Add it to the request header:

Body

application/json
model
enum<string>
required

Kling 2.6 Motion Control model identifier

Available options:
kling-2.6-motion-control
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

input
object

Input parameters for motion control generation

Response

Task submitted successfully

code
enum<integer>
required

Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.

  • 200: Success
  • 400: Invalid request parameters
  • 401: Missing or invalid API key
  • 402: Insufficient credits
  • 403: Permission denied
  • 404: Resource not found
  • 408: Request timeout
  • 429: Rate limit exceeded
  • 500: Internal server error
  • 502: Upstream service error
  • 503: Service unavailable

See Error Codes for details.

Available options:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
Example:

200

data
object
required