---
title: creative_kling_motion_control
description: Animate a reference image with motion from a source video when the
  connected workspace has the Creative flag.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_kling_motion_control
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_kling_motion_control.md
contentType: reference
---

# creative_kling_motion_control

Animate a reference image with motion from a source video when the connected workspace has the Creative flag.

**Operation** Write.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | object | Yes | Video settings. |
| `body.image_url` | string | Yes | Public HTTPS reference image URL. |
| `body.motion_video_url` | string | Yes | Public HTTPS reference video URL. Up to 100 MB. |
| `body.duration_seconds` | number | Yes | Source duration in seconds. Billing uses the measured duration rounded up. |
| `body.character_orientation` | string | No | Use video for clips up to 30 seconds, or image for clips up to 10 seconds. Defaults to video. |
| `body.keep_original_sound` | boolean | No | Keep the source audio. Defaults to true. |
| `body.prompt` | string | No | Describe the desired action or scene. |
| `body.mode` | string | No | Choose async, sync, subscribe, or webhook. |
| `body.wait_timeout_seconds` | integer | No | Maximum synchronous wait from 0 to 30 seconds. |
| `body.webhook_url` | string | No | Public HTTPS URL for the terminal job event. |
| `body.project_id` | string | No | Destination project in the connected workspace. |
| `body.metadata` | object | No | Caller data to keep with the job. |
| `idempotency_key` | string | Yes | Reuse this key to retry the same request. |

Pass `data.job.id` to `creative_jobs_wait`, then read the saved video with `creative_jobs_result`.

## Sample prompt

```text
Animate my character image using the imported dance clip. Keep the clip’s original audio.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
