# Kling Video v2.6 Motion Control [Pro] API

> Pro向けモーション転送：参照動画の動きを静止画内のキャラクターに適用

`image_url` のキャラクターに、`video_url` に示された動作をさせます。`character_orientation` は出力が画像と動画のどちらに従うかを選択します。動画オプションは最大 30 秒の複雑な動きに適しています。テキストの `prompt` は任意で、`keep_original_sound` はデフォルトで参照動画の音声を保持します。Pro モードです。

- Model id: `kling-video/v2.6/pro/motion-control`
- Made by: Kling
- Category: Video to Video
- Output: video
- Price per second of your input video: $0.112 / second of input video (cheapest run $0.112 (112 API credits))
- Run: `POST https://api.doitong.com/v1/run/kling-video/v2.6/pro/motion-control`
- Quote: `POST https://api.doitong.com/v1/quote/kling-video/v2.6/pro/motion-control`
- Docs page: https://doitong.com/ja/developers/models/kling-video/v2.6/pro/motion-control

## Pricing

Price: **$0.112 / second of input video**. Price per second of your input video: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

The full example input below costs $1.12 = 1120 API credits (10 s input video × $0.112).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/kling-video/v2.6/pro/motion-control` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `enable_safety_checker` |  | boolean | no | `true` |  | 安全性チェックを無効にできるのはアカウント認証済みの場合のみです。認証のないリクエストには常にチェックが実行されます。 |
| `prompt` |  | string \| null | no |  | ≤ 2500 characters |  |
| `image_url` | `image` | string (image URL) | yes |  |  | 動画生成用の参照画像URL。ファイルサイズは10.0MB以内、幅と高さは340px～3850px、アスペクト比は0.40～2.50である必要があります。この画像は動画のキャラクター、背景、その他の要素を導きます。キャラクターの場合は、体の比率が明瞭で遮蔽がなく、画像領域の5%を超えていることを確認してください。 |
| `video_url` | `video` | string (video URL) | yes |  |  | キャラクターの動きを出力の指針とする動画を指すURL。遮るもののない現実的なスタイルのキャラクターが映り、頭部と全身または上半身が見えている必要があります。character_orientation 設定により、'image'では長さが10s、'video'では30sに制限されます。ファイルは100 MB以内、幅と高さは340px～3850px、長さは3.0s～30.05sである必要があります。 |
| `keep_original_sound` |  | boolean | no | `true` |  | 参照動画の元の音声を保持するかどうかを制御します。 |
| `character_orientation` |  | enum (string) | yes |  | `image`, `video` | キャラクターの向きのソース: 'image'は参照画像に合わせ、カメラ移動への追従に適しており、最大10秒です。複雑な動きには 'video' が適しており、参照動画の向きに合わせて最大30秒まで指定できます。 |

File parameters (`image`, `video`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
  "character_orientation": "image"
}
```

A fuller example:

```json
{
  "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
  "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
  "character_orientation": "image"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v2.6/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/kling-video/v2.6/pro/motion-control?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/kling-video/v2.6/pro/motion-control", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "kling-video/v2.6/pro/motion-control",
      "input": {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
        "character_orientation": "image"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v2.6/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1120,
    "usd": "1.12",
    "charged": 1120,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size} | モデルが生成した動画。 |

## Related models

- [Kling Video v2.6 Text to Video](https://doitong.com/developers/models/kling-video/v2.6/pro/text-to-video.md) (`kling-video/v2.6/pro/text-to-video`): from $0.07 / second
- [Kling Video v2.6 Image to Video](https://doitong.com/developers/models/kling-video/v2.6/pro/image-to-video.md) (`kling-video/v2.6/pro/image-to-video`): from $0.07 / second
- [Kling Video v2.6 Motion Control \[Standard\]](https://doitong.com/developers/models/kling-video/v2.6/standard/motion-control.md) (`kling-video/v2.6/standard/motion-control`): $0.07 / second of input video
- [Kling O1 Edit Video \[Pro\]](https://doitong.com/developers/models/kling-video/o1/video-to-video/edit.md) (`kling-video/o1/video-to-video/edit`): $0.168 / second of input video
- [Kling O1 Edit Video \[Standard\]](https://doitong.com/developers/models/kling-video/o1/standard/video-to-video/edit.md) (`kling-video/o1/standard/video-to-video/edit`): $0.126 / second of input video
- [Kling O1 Reference Video to Video \[Pro\]](https://doitong.com/developers/models/kling-video/o1/video-to-video/reference.md) (`kling-video/o1/video-to-video/reference`): $0.168 / second
- [Kling O1 Reference Video to Video \[Standard\]](https://doitong.com/developers/models/kling-video/o1/standard/video-to-video/reference.md) (`kling-video/o1/standard/video-to-video/reference`): $0.126 / second
- [Kling O3 Edit Video \[Pro\]](https://doitong.com/developers/models/kling-video/o3/pro/video-to-video/edit.md) (`kling-video/o3/pro/video-to-video/edit`): $0.168 / second of input video

## Links

- HTML page: https://doitong.com/developers/models/kling-video/v2.6/pro/motion-control
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=kling-video/v2.6/pro/motion-control
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/kling-video/v2.6/pro/motion-control