## Basic model info

Model name: kwaivgi/kling-v3-motion-control
Model description: Kling 3.0 motion control: transfer motion from a reference video to any character image with improved consistency and quality.


## Model inputs

- prompt (optional): Text prompt for video generation. You can add elements to the screen and achieve motion effects through prompt words. (string)
- image (required): 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. (string)
- video (required): 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. (string)
- character_orientation (optional): 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. (string)
- mode (optional): Video generation mode. 'std': Standard mode (720p, cost-effective). 'pro': Professional mode (1080p, higher quality). (string)
- keep_original_sound (optional): Whether to keep the original sound of the reference video (boolean)


## Model output schema

{
  "type": "string",
  "title": "Output",
  "format": "uri"
}

If the input or output schema includes a format of URI, it is referring to a file.


## Example inputs and outputs

Use these example outputs to better understand the types of inputs the model accepts, and the types of outputs the model returns:

### Example (https://replicate.com/p/xywvkckh45rmt0cwqwjs7b78qc)

#### Input

```json
{
  "mode": "std",
  "image": "https://replicate.delivery/pbxt/OhIQnoiXw7PFYLQQDxwGzzHQ6Wo0PzVzlq0KupODosHDAtH6/jennai-office.jpeg",
  "video": "https://replicate.delivery/pbxt/OhIQobmzRaHU3DFWKOvUO92sXBDWxxPQnHPgl6G27KgohBe4/man-office-waving.mp4",
  "prompt": "",
  "keep_original_sound": true,
  "character_orientation": "video"
}
```

#### Output

```json
"https://replicate.delivery/xezq/8ReqUVx1Q03tPK8PTWv6mh5qGOGNp5fm5xu1kzmGT4yZeubsA/tmpvgmrtp4z.mp4"
```


### Example (https://replicate.com/p/14wsntwbr9rmr0cwqwmtc9eqhr)

#### Input

```json
{
  "mode": "pro",
  "image": "https://replicate.delivery/pbxt/OhIV2XlJvGTqBU5tj7eqERHM0ajsSbbUFdtIHGUcgY5ovzCV/replicate-prediction-e96y5mp789rmy0cv8vwr93mg.jpeg",
  "video": "https://replicate.delivery/pbxt/OhIV2COnAaznBxYf3vPq8vBDeGhK7TN1qAykiXdBZuxOkIaI/boxer-man.mp4",
  "prompt": "a woman boxing",
  "keep_original_sound": true,
  "character_orientation": "video"
}
```

#### Output

```json
"https://replicate.delivery/xezq/clzg3wft6RQhekz8wpAfpDtSMd44ICTxff3MIiO2Br2fJ6djF/tmp4y4bp6jz.mp4"
```


### Example (https://replicate.com/p/whre1ymhxsrmr0cwqwpvbrnngm)

#### Input

```json
{
  "mode": "pro",
  "image": "https://replicate.delivery/pbxt/OJ9QUddI9pD9VIYTSSFdtfiRl1P3Xoe7gsSMRIm2rOVDhuzB/harley-vert2.webp",
  "video": "https://replicate.delivery/pbxt/OhIZDk0FlGabME8R8jJD3PW0LmxB5bltRYTK3UlevY5GuEPX/man-clip.mp4",
  "prompt": "",
  "keep_original_sound": true,
  "character_orientation": "video"
}
```

#### Output

```json
"https://replicate.delivery/xezq/i748h9oPvLp6Ktupd1oFRcNbzcGl5j9gZCfDyHsv4MrN07GLA/tmp7gzjazeo.mp4"
```


## Model readme

> # Kling 3.0 motion control
> 
> Transfer character motion from a reference video to any image with improved consistency and quality.
> 
> ## About
> 
> Kling 3.0 motion control generates videos where character actions match a reference video while the visual appearance is based on a reference image. Provide an image of a character and a video showing the motion you want, and the model produces a new video combining the character's look with the reference motion.
> 
> This V3.0 update brings improved element consistency and higher quality output compared to V2.6, with better preservation of character identity and smoother motion transfer.
> 
> ## How it works
> 
> 1. Upload a **reference image** — the character whose appearance you want in the output
> 2. Upload a **reference video** — the motion you want the character to follow
> 3. Optionally add a **text prompt** to guide elements, backgrounds, and motion effects
> 4. Choose **character orientation**: `image` keeps the character facing the same direction as in the picture (max 10s), `video` matches the character's orientation in the reference video (max 30s)
> 5. Choose **mode**: `std` for 720p (cost-effective) or `pro` for 1080p (higher quality)
> 
> The model transfers the motion from your reference video onto the character from your image, generating smooth, natural-looking animation.
> 
> ## Use cases
> 
> **Dance and gesture transfer**: Make any character perform a specific dance or gesture from a reference video.
> 
> **Character animation**: Bring illustrated or photographed characters to life with realistic motion from real footage.
> 
> **Social media content**: Create eye-catching videos by combining a subject's look with trending motion clips.
> 
> **Marketing and advertising**: Animate product mascots or brand characters with specific movements.
> 
> ## Tips
> 
> Keep character proportions consistent between the image and the reference video. Avoid using a full-body reference video with a half-body image.
> 
> Make sure the character's entire body and head are clearly visible and not obstructed in the reference image.
> 
> For best results, use reference videos with clear, steady movements. The model handles moderate motion well but may struggle with very fast or chaotic movement.
> 
> Match your text prompt to the motion being transferred to help the model understand context.
> 
> ## Privacy policy
> 
> Data from this model is sent from Replicate to Kuaishou. [https://app.klingai.com/global/dev/privacy-policy](https://app.klingai.com/global/dev/privacy-policy)
> 
> ## Terms of service
> 
> [https://app.klingai.com/global/dev/service-agreement](https://app.klingai.com/global/dev/service-agreement)

