> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling V3.0 Motion Control

Kling V3.0 Motion Control extracts motion trajectories from reference videos and applies them to reference images to generate videos while maintaining subject consistency. Supports standard and professional modes with per-second billing.

<Tip>
  This is an **asynchronous** API; only the **task\_id** will be returned. You should use the **task\_id** to request the [**Task Result API**](/api-reference/model-apis-task-result) to retrieve the video generation results.
</Tip>

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Supports: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="image" type="string" required={true}>
  Reference image URL or base64 encoded image; supports .jpg, .jpeg, .png.
  Image file size must not exceed 10MB; width and height must be >= 300px; aspect ratio must be between 1:2.5 and 2.5:1.
</ParamField>

<ParamField body="video" type="string" required={true}>
  Reference motion video URL; supports .mp4, .mov.
  Video file size must not exceed 10MB; width and height must be >= 300px; duration 3-30 seconds.
</ParamField>

<ParamField body="prompt" type="string">
  Positive prompt for scene description, style, lighting; must not exceed 2500 characters.

  Length limit: 0 - 2500
</ParamField>

<ParamField body="model_name" type="string" required={true} default="kling-v3-0-std">
  Model name. kling-v3-0-std: standard mode, cost-effective; kling-v3-0-pro: professional mode, higher video quality.

  Optional values: `kling-v3-0-std`, `kling-v3-0-pro`
</ParamField>

<ParamField body="negative_prompt" type="string">
  Negative prompt describing elements to avoid in the generated video; must not exceed 2500 characters.

  Length limit: 0 - 2500
</ParamField>

<ParamField body="keep_original_sound" type="boolean" default={true}>
  Whether to keep the original audio from the reference video.
</ParamField>

<ParamField body="character_orientation" type="string" required={true}>
  Output frame mode:

  * image: uses the reference image's pose and composition, transfers motion to the image subject (outputs 5 seconds)
  * video: uses the reference video's pose and composition, applies video motion to the image subject (output duration matches reference video, up to 30 seconds)

  Optional values: `image`, `video`
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={true}>
  Use the task\_id to request the [Task Result API](/api-reference/model-apis-task-result) to retrieve the generated outputs.
</ResponseField>
