> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# Kling v3 Motion Control

> Kling 3.0 model that transfers motion from a reference video onto a character from a reference image, with Standard 720p and Pro 1080p tiers.

![Kling v3 Motion Control](https://media.empiriolabs.ai/model-logos/kling-v3-motion-ctrl.png)

[Kling AI](/providers/kling) · Video Generation

`POST /v1/videos/generations`

Kling 3.0 model that transfers motion from a reference video onto a character from a reference image, with Standard 720p and Pro 1080p tiers.

## At a glance

| Field               | Value                                                        |
| ------------------- | ------------------------------------------------------------ |
| Model id            | `kling-v3-motion-control`                                    |
| Model release date  | -                                                            |
| Input modalities    | Text, Image, Video                                           |
| Output modalities   | Video                                                        |
| Context window      | -                                                            |
| Weight precision    | -                                                            |
| Features            | motion_control                                               |
| Native inference    | No                                                           |
| New                 | No                                                           |
| Supported endpoints | `POST /v1/videos/generations`                                |
| Alternate model ids | `kling-v3-motion`, `kling-v3-motion-ctrl`, `kling/v3-motion` |

## Pricing

| Charge          | Spec       | Rate   |
| --------------- | ---------- | ------ |
| Standard (720p) | per second | \$0.14 |
| Pro (1080p)     | per second | \$0.18 |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/videos/generations \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "kling-v3-motion-control", "prompt": "sunrise over the ocean", "duration": 6}'
```

## Parameters

| Parameter               | Type    | Required | Default   | Description                                                                                                                                                                                                                                                     |
| ----------------------- | ------- | -------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`                | string  | yes      | -         | Motion / scene description.                                                                                                                                                                                                                                     |
| `reference_image`       | string  | yes      | -         | URL of the reference image that provides the character or subject.                                                                                                                                                                                              |
| `reference_video`       | string  | yes      | -         | URL of the reference video that provides the motion to copy.                                                                                                                                                                                                    |
| `character_orientation` | enum    | no       | `"image"` | image: character starts in the pose from the reference image (max 10s). video: character matches pose in the reference video (max 30s). · Allowed: `image`, `video`                                                                                             |
| `mode`                  | enum    | no       | `"std"`   | std: standard quality. pro: higher quality, slower. · Allowed: `std`, `pro`                                                                                                                                                                                     |
| `duration`              | number  | no       | `4`       | Clip length in seconds. The reference video is trimmed to this length, so a shorter reference gives a shorter clip, and the bill follows the clip returned. Capped at 10 when character_orientation=image, 30 when character_orientation=video. · Range: 1 – 30 |
| `keep_original_sound`   | boolean | no       | true      | Keep the audio track from the reference video.                                                                                                                                                                                                                  |

## Notes

Motion-control video: a reference IMAGE (the character/subject) and a reference VIDEO (the motion source) are BOTH required. The character from the image performs the movements from the video.

**Reference image**

* JPEG, PNG, or WEBP
* Max 10 MB
* Min 340px on the short edge
* Aspect ratio 0.4 to 2.5

**Reference video**

* MP4, MOV, or WEBM
* Max 100 MB
* 340-3850px
* 24-60 FPS
* 3-10s (image orientation: max 10s; video orientation: max 30s)

**Uploaded media preprocessing**

* Reference videos are normalized to provider-compatible MP4 when needed.
* Reference-video duration follows the selected character orientation limit.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/kling-v3-motion-control`.