model: kling-v3-motion 來存取 Kling V3 動態控制。提供外觀與動態參考，提交單一非同步請求，並透過輪詢或回呼追蹤回傳的 img_uuid。用於參考引導式角色影片的 Kling V3 動態控制 API
透過 GoEnhance 使用
取得 API 金鑰
在單一請求中結合外觀與動態參考
在提交前驗證媒體；不支援的持續時間或解析度數值應在用戶端拒絕。
Kling V3 動態控制 API 功能與驗證規則
端點與模型
POST 至 <code>https://api.goenhance.ai/api/v1/videos/generations</code> 並使用 <code>model: kling-v3-motion</code>。
提示詞
傳送必要的 <code>prompt</code>（最多 2,500 個字元），以描述角色、服裝、場景或相關生成方向。
外觀輸入
<code>image_url</code> 可為 JPG、JPEG 或 PNG 格式，上限 50 MB，每邊至少 300 像素，長寬比介於 1:2.5 至 2.5:1 之間。
動態輸入
必要的 <code>video_url</code> 必須是 MP4 或 MOV 格式，上限 100 MB，尺寸介於 340 至 3,850 像素之間。
方向與長度
<code>character_orientation: video</code> 接受 3–30 秒；<code>image</code> 接受 3–10 秒。文件預設值為 <code>video</code>。
解析度與音訊
選擇 720p 或 1080p；無 4K 等級。<code>generate_audio</code> 會保留動態影片的原始聲音，預設為 false。
定價按生成的秒數計算，而 GoEnhance 則將輸入的動作影片長度作為請求的上限收費標準。
Kling V3 動態控制 API 定價
720p 費率
每生成一秒 6.3 個代幣，相當於每秒 $0.126（以文件記載的每代幣 $0.02 計算）。
1080p 費率
每生成一秒 8.4 個代幣，相當於每秒 $0.168（以文件記載的每代幣 $0.02 計算）。
成本估算
將請求成本上限估算為測量的動態影片持續時間乘以所選解析度的確切費率。
計量輸入計費
GoEnhance 會在扣除代幣前傳輸並測量 <code>video_url</code>，因此在測量後更改遠端檔案不會改變計費輸入。
輸出長度可能較短
Kling 會提取可用的連續動作，因此困難或非常快速的動作可能會產生比參考影片更短的輸出。
無持續時間參數
請勿發送 <code>duration</code>；端點會拒絕該參數，輸出長度將遵循從參考影片中提取的可利用動作。
透過六個步驟整合 Kling V3 Motion Control
1
1. 建立 API 金鑰
建立 GoEnhance API 金鑰並將其發送至
Authorization 標頭中。 2
2. 驗證兩個參考資料
檢查影像清晰度和尺寸，然後驗證動作影片的格式、大小、尺寸以及依據方向決定的長度。
3
3. 提交並持久化任務
使用
model: kling-v3-motion 發送 POST 請求，然後在將工作交給後台處理器之前儲存返回的 img_uuid。 4
4. 追蹤狀態
輪詢
GET /api/v1/jobs/detail 或提供一個可公開存取的 HTTPS custom_callback_url。 5
5. 冪等處理回呼
安全地處理重複的狀態事件。未返回 HTTP 200 的回呼可能會被重試最多三次，每次嘗試的逾時時間為三秒。
6
6. 儲存最終結果
將處理、成功和失敗處理分開，並僅在任務達到終止狀態後儲存最終影片 URL。
使用您有權處理的媒體，並為非同步完成進行設計。
Kling V3 Motion Control 的開發者使用案例
角色表演片段
將核准的動作參考應用於一致的角色外觀，用於短篇敘事或宣傳影片製作流程。
舞蹈與編舞預覽
將授權的排練動作轉換為角色主導的預覽，同時保留同意權與原始音訊權利。
遊戲角色動畫概念
在投入完整的動畫工作流程之前，根據角色藝術和錄製的動作生成動作研究。
在地化行銷活動變體
為區域性創意變體參數化提示詞與外觀輸入，同時重複使用單一任務編排層。
虛擬表演者工作流程
圍繞核准的影像參考、動作資產和方向設定，建立受控的表演者製作流程。
預覽製作
在進行後續編輯、合成和審閱之前，測試動作參考是否適合該角色。
關於整合、定價、驗證及快手 API 常見問題的解答。