メインコンテンツへスキップ
POST
/
v3
/
async
/
kling-v3.0-motion-control
Kling V3.0 モーション制御
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
Kling V3.0 モーション制御ツールは、参照動画から動きの軌跡を抽出し、それを参照画像に適用して動画を生成できます。同時に主体の一貫性を維持します。標準モードとプロモードをサポートし、秒単位で課金されます。
これは非同期APIであり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API にリクエストし、生成結果を取得してください。

​
リクエストヘッダー

​
Content-Type
string
必須
列挙値: application/json
​
Authorization
string
必須
Bearer 認証形式: Bearer {{API キー}}。

​
リクエストボディ

​
image
string
必須
参照画像 URL または base64 エンコード画像。.jpg、.jpeg、.png をサポートします。 画像ファイルサイズは 10MB を超えてはなりません。幅と高さはいずれも >= 300px である必要があります。アスペクト比は 1:2.5 から 2.5:1 の間である必要があります。
​
video
string
必須
参照モーション動画 URL。.mp4、.mov をサポートします。 動画ファイルサイズは 10MB を超えてはなりません。幅と高さはいずれも >= 300px である必要があります。長さは 3〜30 秒です。
​
prompt
string
シーンの説明、スタイル、照明などのポジティブプロンプト。長さは 2500 文字以内です。長さ制限：0 - 2500
​
model_name
string
デフォルト:"kling-v3-0-std"
必須
モデル名。kling-v3-0-std：標準モード、コストパフォーマンスに優れています。kling-v3-0-pro：プロモード、より高品質な動画を生成します。選択可能な値：kling-v3-0-std, kling-v3-0-pro
​
negative_prompt
string
ネガティブプロンプト。生成動画で避けたい要素を記述します。長さは 2500 文字以内です。長さ制限：0 - 2500
​
keep_original_sound
boolean
デフォルト:true
参照動画の元の音声を保持するかどうか。
​
character_orientation
string
必須
出力フレームモード：
  • image：参照画像の人物の姿勢と構図を主とし、動きを画像内の人物に転移します（出力 5 秒）
  • video：参照動画の人物の姿勢と構図を主とし、動画内の動きを画像内の人物に適用します（出力時間は参照動画と同じ、最長 30 秒）
選択可能な値：image, video

​
レスポンス情報

​
task_id
string
必須
task_id を使用して タスク結果照会 API にリクエストし、生成された出力を取得します。