用於參考引導式角色影片的 Kling V3 動態控制 API

透過 GoEnhance 使用 model: kling-v3-motion 來存取 Kling V3 動態控制。提供外觀與動態參考,提交單一非同步請求,並透過輪詢或回呼追蹤回傳的 img_uuid。
取得 API 金鑰
用於 Kling V3 動態控制 API 的電影級動態參考製作

在單一請求中結合外觀與動態參考

定義角色外觀

使用 image_url 提供清晰的上半身或全身角色影像,或透過 element_ids 最多使用一個 Kling 元素。元素輸入會強制設定 character_orientation: video。
用於角色影片生成的受控外觀參考攝影

從參考影片傳輸動態

在 video_url 中提供必要的 MP4 或 MOV 檔案。輸出將遵循該檔案中可用的連續動態;此端點沒有 duration 參數。
用作動態參考的單場景編舞排練
在提交前驗證媒體;不支援的持續時間或解析度數值應在用戶端拒絕。

Kling V3 動態控制 API 功能與驗證規則

端點與模型

POST 至 https://api.goenhance.ai/api/v1/videos/generations 並使用 model: kling-v3-motion。

提示詞

傳送必要的 prompt(最多 2,500 個字元),以描述角色、服裝、場景或相關生成方向。

外觀輸入

image_url 可為 JPG、JPEG 或 PNG 格式,上限 50 MB,每邊至少 300 像素,長寬比介於 1:2.5 至 2.5:1 之間。

動態輸入

必要的 video_url 必須是 MP4 或 MOV 格式,上限 100 MB,尺寸介於 340 至 3,850 像素之間。

方向與長度

character_orientation: video 接受 3–30 秒;image 接受 3–10 秒。文件預設值為 video。

解析度與音訊

選擇 720p 或 1080p;無 4K 等級。generate_audio 會保留動態影片的原始聲音,預設為 false。
定價按生成的秒數計算,而 GoEnhance 則將輸入的動作影片長度作為請求的上限收費標準。

Kling V3 動態控制 API 定價

720p 費率

每生成一秒 6.3 個代幣,相當於每秒 $0.126(以文件記載的每代幣 $0.02 計算)。

1080p 費率

每生成一秒 8.4 個代幣,相當於每秒 $0.168(以文件記載的每代幣 $0.02 計算)。

成本估算

將請求成本上限估算為測量的動態影片持續時間乘以所選解析度的確切費率。

計量輸入計費

GoEnhance 會在扣除代幣前傳輸並測量 video_url,因此在測量後更改遠端檔案不會改變計費輸入。

輸出長度可能較短

Kling 會提取可用的連續動作,因此困難或非常快速的動作可能會產生比參考影片更短的輸出。

無持續時間參數

請勿發送 duration;端點會拒絕該參數,輸出長度將遵循從參考影片中提取的可利用動作。

透過六個步驟整合 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。
取得 API 金鑰
使用您有權處理的媒體,並為非同步完成進行設計。

Kling V3 Motion Control 的開發者使用案例

角色表演片段

將核准的動作參考應用於一致的角色外觀,用於短篇敘事或宣傳影片製作流程。

舞蹈與編舞預覽

將授權的排練動作轉換為角色主導的預覽,同時保留同意權與原始音訊權利。

遊戲角色動畫概念

在投入完整的動畫工作流程之前,根據角色藝術和錄製的動作生成動作研究。

在地化行銷活動變體

為區域性創意變體參數化提示詞與外觀輸入,同時重複使用單一任務編排層。

虛擬表演者工作流程

圍繞核准的影像參考、動作資產和方向設定,建立受控的表演者製作流程。

預覽製作

在進行後續編輯、合成和審閱之前,測試動作參考是否適合該角色。
關於整合、定價、驗證及快手 API 常見問題的解答。

Kling V3 動作控制 API 常見問題解答

Kling V3 動態控制 API 端點是什麼?

透過 GoEnhance 以 POST https://api.goenhance.ai/api/v1/videos/generations 提交,並指定 model: kling-v3-motion。回應會返回一個 img_uuid。

Kling V3 動態控制 API 定價是如何運作的?

720p 的費用為 6.3 tokens/s($0.126/s),1080p 的費用為 8.4 tokens/s($0.168/s)。GoEnhance 會在扣款前測量動態影片的持續時間,並以此作為請求的收費上限。

我可以發送持續時間參數嗎?

不行。此端點會拒絕 duration。參考影片必須符合特定方向的限制,且輸出結果將遵循從中提取出的可用連續動作。

character_orientation 有什麼作用?

video 會遵循動態影片中的朝向,並允許 3–30 秒的長度。image 會遵循外觀圖像,並允許 3–10 秒的長度。

API 可以生成原生音訊嗎?

不行。generate_audio 僅保留動態影片的原始音軌。預設值為 false;請僅在擁有必要權利時使用音訊。

我可以使用 Kling 元素代替圖像嗎?

V3 路由透過 element_ids(或單值別名 element_id)最多接受一個值。元素輸入會強制設定為 character_orientation: video。

回調(callbacks)是如何運作的?

請提供一個公開的 HTTPS custom_callback_url。回調主體與作業詳細資訊的回應相符;若傳送失敗(非 200 狀態碼),最多可重試三次,每次逾時時間為三秒。

這是快手的官方 API 嗎?

不是。Kling 與快手有關聯,但本頁面描述的是透過 GoEnhance 進行的獨立存取。GoEnhance 並非以快手或 Kling 的官方 API、合作夥伴或模型開發者的身份呈現。

使用 Kling V3 動作控制 API 進行開發

Kling V3 動態控制 API 與定價 | GoEnhance