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

# Klingモーション制御

> キャラクター画像と動きの参照動画からKling動画を生成します。

`Authorization: Bearer $MIXROUTE_API_KEY`を使用してMixRouteのAPIキーで認証し、JSONを送信してください。モデルIDはボディの`model`フィールドではなく、URLに含めます。`/v1`を追加したり、リクエストを`metadata`で囲んだりしないでください。

`kling-3.0`と`kling-2.6`に対応し、どちらも`720p` / `1080p`のみ利用可能で、`4k`には対応していません。これは参照動画に基づいてキャラクターの動きを制御する機能であり、独立したモーションモデルでも、カメラの動きだけを設定するものでもありません。

## リクエストパラメーター

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `contents` | object\[] | はい | 外観を指定する画像と動きを指定する動画、および任意のプロンプトを含む入力の集合。 |
| `contents[].type` | string | はい | 項目ごとに必須：prompt、image、video。3.0はelementもサポートします。 |
| `contents[].text` | string | 種類別 | prompt項目には必須で、最大2500文字です。含めたい内容と除外したい内容の両方を記述できます。 |
| `contents[].url` | string | 種類別 | 画像・動画項目では必須。画像にはURLまたはBase64を指定でき、動画には公開URLを使用します。 |
| `contents[].element_id` | string | 種類別 | 3.0のelement項目のみで必須です。Elementは最大1つ。 |
| `contents[].id` | string | 種類別 | element項目には必須です。タスク内で一意である必要があり、@idとして参照します。 |
| `settings.character_orientation` | string | はい | video: 動画内のキャラクターの向きに従い、参照動画の長さは3～30秒。image: 画像内のキャラクターの向きに従い、参照動画の長さは3～10秒。Elementを使用する場合、キャラクターの向きは動画に従うため、videoを設定してください。 |
| `settings.resolution` | string | いいえ | 720p（デフォルト）または1080p。4kには対応していません。 |
| `settings.audio` | string | いいえ | original（デフォルト）は参照音声を保持し、offは音声を削除します。nativeには対応していません。 |

<Warning>
  `settings.duration`を送信しないでください。利用可能な連続した動きによって出力の長さが決まるため、参照動画より短くなる場合があります。少なくとも3秒間の利用可能な動きが必要です。課金は実際に生成された長さに基づきます。
</Warning>

## メディアの制限

* 画像: JPG/JPEG/PNG、最大50 MB。縦横ともに300 px以上、アスペクト比は1:2.5～2.5:1。
* 動画: MP4/MOV、最大100 MB、各辺340～3850 px。長さはcharacter\_orientationによって異なります。
* 画像と動画で人物の体の比率を合わせてください。頭部と四肢が隠れずにはっきり見えるようにします。1人の人物が映る連続した単一ショットが適しています。カットの切り替えや速い動きは避けてください。

## リクエスト例

環境変数`MIXROUTE_API_KEY`を設定してください。`example.com`のメディアURLは、実際の公開アクセス可能なファイルに置き換えてください。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/kling/motion-control/kling-3.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "type": "prompt",
      "text": "The person follows the reference motion."
    },
    {
      "type": "image",
      "url": "https://example.com/person.png"
    },
    {
      "type": "video",
      "url": "https://example.com/motion.mp4"
    }
  ],
  "settings": {
    "resolution": "720p",
    "character_orientation": "video",
    "audio": "original"
  }
}'
```

[Klingの概要](/ja/api-reference/endpoint/kling)を参照してください。

## 送信時のレスポンス

```json theme={null}
{
  "code": 0,
  "message": "",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "task_example",
    "status": "submitted"
  }
}
```

`data.id`を保持し、`succeeded`または`failed`になるまで[Klingタスクの照会](/ja/api-reference/endpoint/kling-tasks)を使用してください。送信の成功は、生成の完了を意味しません。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.