跳到正文
kling-v3-motion-control影片範例 2026-09-25 實測通過

可靈 3.0 動作控制

動作控制:1 張人物圖 + 1 段動作影片,最高 4K。

可靈 3.0 動作控制(kling-v3-motion-control)讓一張人物圖片跟隨一段影片裡的動作,輸出 720p、1080p、2K 或 4K。時長跟隨輸入影片,不產生音訊。依輸出時長計費,官方價:720p $0.1324 / 秒,1080p $0.1765 / 秒,2K $0.2647 / 秒,4K $0.3971 / 秒。向 POST /v1/video/generate 傳一張圖片與一段影片(不傳 duration),再輪詢 GET /v1/video/tasks/{task_id}。

官方價
$0.1324起/ 秒按輸出時長計費
解析度
720p · 1080p · 2K · 4K
支援
動作控制
注意
  • 素材規格在執行時才檢查,不合規會在提交幾分鐘後失敗(不計費)。
  • 結果連結自完成起 24 小時後失效。
  • 不傳 duration,時長跟隨輸入影片;不出聲音。
查看串接文件

價格明細

官方價(美元)。實際扣費 = 官方價 × 分組倍率。

720p · 動作控制
$0.1324 / 秒
1080p · 動作控制
$0.1765 / 秒
2K · 動作控制
$0.2647 / 秒
4K · 動作控制
$0.3971 / 秒

呼叫端點

快速呼叫

把 sk-your-key 換成所在分組包含該模型的密鑰。

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-motion-control",
    "prompt": "Follow the movement in the video",
    "resolution": "1080p",
    "images": [{ "url": "https://example.com/person.png" }],
    "videos": [{ "url": "https://example.com/dance.mp4" }],
    "extra": { "character_orientation": "video" }
  }'

# Poll with the returned task ID until it completes
curl https://api.hop-base.com/v1/video/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-key"

常見問題

動作控制需要什麼輸入?
恰好一張人物圖片與一段動作影片。動作影片裡必須有真人,且完整上半身(頭到腰)清楚可見;沒有真人(如動物)或上半身被裁切、遮擋的影片,任務會在提交幾分鐘後失敗。
動作影片最長幾秒?
extra.character_orientation 為 "image" 時最長 10 秒,為 "video"(預設)時最長 30 秒。更長的影片會在提交後不久以 reference_input_invalid 失敗。
怎麼計費?
依輸出時長計費,時長等於輸入影片的長度,所以不要傳 duration。官方價:720p $0.1324 / 秒,1080p $0.1765 / 秒,2K $0.2647 / 秒,4K $0.3971 / 秒。實際扣費 = 官方價 × 分組倍率;素材不合規導致的失敗不計費。

同族模型

價格取自公開目錄;上下限取自閘道驗證程式碼匯出的規格。實際扣費 = 官方價 × 分組倍率。