---
title: "Motion Control Video Endpoint"
method: POST
path: "/api/videos/motion-control"
---

# Motion Control Video Endpoint

`POST /api/videos/motion-control`

Generate a motion control video using Kling Motion Control models.

Transfers motion from a reference video to a character image, creating a new video
where the character performs the movements from the reference.

Args:
    request: JSON body containing:
        - project_id (str, required): Project ID to add the video to
        - prompt (str, required): Text prompt describing the desired output
        - image_url (str, required): URL of the character image to animate
        - video_url (str, required): URL of the reference video (3-30 seconds)
        - model (str, optional): One of "kling26mc", "kling26mcpro", "kling3mc", "kling3mcpro"
        - character_orientation (str, optional): "image" or "video". Default: "image"
        - keep_original_sound (bool, optional): Keep reference video audio. Defaults to True for Kling 3, False for Kling 2.6
        - duration (str, optional): Duration in seconds ("5" or "10"). Default: "5"
        - negative_prompt (str, optional): Text specifying elements to avoid
        - order_index (int, optional): Position in timeline. Default: append at end
        - start_keyframe_id (str, optional): ID of the keyframe used as character image
        - video_id (str, optional): Existing video ID to regenerate in place

Returns:
    Success response with video data

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)