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

# Kling V3.0 モーション制御

Kling V3.0 モーション制御ツールは、参照動画から動きの軌跡を抽出し、それを参照画像に適用して動画を生成できます。同時に主体の一貫性を維持します。標準モードとプロモードをサポートし、秒単位で課金されます。

<Tip>
  これは**非同期**APIであり、非同期タスクの task\_id のみを返します。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください。
</Tip>

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  列挙値: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API キー}}。
</ParamField>

## リクエストボディ

<ParamField body="image" type="string" required={true}>
  参照画像 URL または base64 エンコード画像。.jpg、.jpeg、.png をサポートします。
  画像ファイルサイズは 10MB を超えてはなりません。幅と高さはいずれも >= 300px である必要があります。アスペクト比は 1:2.5 から 2.5:1 の間である必要があります。
</ParamField>

<ParamField body="video" type="string" required={true}>
  参照モーション動画 URL。.mp4、.mov をサポートします。
  動画ファイルサイズは 10MB を超えてはなりません。幅と高さはいずれも >= 300px である必要があります。長さは 3〜30 秒です。
</ParamField>

<ParamField body="prompt" type="string">
  シーンの説明、スタイル、照明などのポジティブプロンプト。長さは 2500 文字以内です。

  長さ制限：0 - 2500
</ParamField>

<ParamField body="model_name" type="string" required={true} default="kling-v3-0-std">
  モデル名。kling-v3-0-std：標準モード、コストパフォーマンスに優れています。kling-v3-0-pro：プロモード、より高品質な動画を生成します。

  選択可能な値：`kling-v3-0-std`, `kling-v3-0-pro`
</ParamField>

<ParamField body="negative_prompt" type="string">
  ネガティブプロンプト。生成動画で避けたい要素を記述します。長さは 2500 文字以内です。

  長さ制限：0 - 2500
</ParamField>

<ParamField body="keep_original_sound" type="boolean" default={true}>
  参照動画の元の音声を保持するかどうか。
</ParamField>

<ParamField body="character_orientation" type="string" required={true}>
  出力フレームモード：

  * image：参照画像の人物の姿勢と構図を主とし、動きを画像内の人物に転移します（出力 5 秒）
  * video：参照動画の人物の姿勢と構図を主とし、動画内の動きを画像内の人物に適用します（出力時間は参照動画と同じ、最長 30 秒）

  選択可能な値：`image`, `video`
</ParamField>

## レスポンス情報

<ResponseField name="task_id" type="string" required={true}>
  task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成された出力を取得します。
</ResponseField>