Kling v3 モーション制御

APIMaster で kling-v3-motion-control を呼び出して Kling モーション制御を行います。参照画像と参照動画を用意し、出力は参照クリップの動きに従います。オプションのプロンプトでカメラやスタイルを調整できます。

ベースURL: https://apimaster.ai/v1 は https://apimaster.ai/v1 です。https://apimaster.ai/v1/videos/... を使ってください。先頭にさらに /v1 を付けないでください。

料金（秒単位）

課金対象時間は、サーバーが video_url をプローブして決定します（クライアント側の推測ではありません）。事前引き落としには mode と向きに基づく最大時間を使用します。

モード	料金
std	$0.10288 / 秒
pro	$0.13712 / 秒

例: 8 秒 の参照動画 @ std ≈ $0.82304（$0.10288 × 8）。

送信

POST https://apimaster.ai/v1/videos/generations

フィールド	型	必須	説明
model	string	はい	kling-v3-motion-control
image_url	string	はい	公開参照画像のURL
video_url	string	はい	公開参照動画のURL（mp4/mov、100MB以下）
character_orientation	string	はい	image（参照動画3～10秒）または video（3～30秒）
mode	string	はい	std または pro
prompt	string	いいえ	動き・カメラ・スタイルのヒント（任意）
keep_original_sound	string	いいえ	yes（デフォルト）または no
watermark_info	object	いいえ	例: {"enabled": false}
duration	integer	いいえ	事前引き落としの見積もりに使用（任意）。確定はプローブされた長さに基づく

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-motion-control",
    "prompt": "Match face identity, follow the reference dance, cinematic lighting",
    "image_url": "https://example.com/ref-image.png",
    "video_url": "https://example.com/ref-video-8s.mp4",
    "character_orientation": "image",
    "mode": "std",
    "keep_original_sound": "yes"
  }'

レスポンス

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxx"
    }
  ]
}

参照動画の長さ

character_orientation	許可される参照動画
image	3秒～10秒
video	3秒～30秒

ポーリング

GET https://apimaster.ai/v1/videos/{task_id}

返された url または GET https://apimaster.ai/v1/videos/{task_id}/content からダウンロードします。