可靈 Kling 影片 API 規範

kling-3.0-turbo 依解析度計費（720P / 1080P / 2K / 4K）的呼叫方式，以及時長、比例、參考圖片與影片、首尾影格與音訊規則。

本頁是快手可靈影片模型 kling-3.0-turbo 的呼叫規範。此模型與其他影片模型共用 POST /v1/videos 建立、GET /v1/videos/{id} 輪詢的流程；驗證、素材上傳、輪詢狀態、結果下載與錯誤處理請見影片 API 完整呼叫規範，本頁只列出可靈專屬的欄位與規則。

更新於 2026-10-10。可靈模型只支援輪詢：提交時請勿設定 callback_url，否則請求會被拒絕。

模型一覽

模型	可選解析度	時長	比例	圖／影片／音訊上限
`kling-3.0-turbo`	`720p`（預設）、`1080p`、`2k`、`4k`	4–15 秒，預設 5 秒	`16:9` `9:16` `1:1`，預設 `16:9`	30（含首尾影格）/ 10 / 0

以 resolution 選擇輸出規格並依該規格計費，大小寫皆可（4k 與 4K 等價）；未傳時使用最低規格 720p。填入不支援的規格會回傳 400，不會自動降級。

通用規則

時長：duration（或字串形式的 seconds）填整數秒，範圍 4–15 秒，未傳時為 5 秒。
比例：ratio（或 aspect_ratio）可選 16:9、9:16、1:1。
提示詞：prompt 為必填，最長 2000 個字元。
生成音訊：支援 generate_audio（布林值）。
參考音訊：不支援，提交參考音訊會回傳 400。
選填欄位：negative_prompt（負面提示詞）、seed（整數）。

參考圖片與影片

參考圖片放在頂層 images，參考影片放在 metadata.referenceVideos。圖片最多 30 張（首尾影格也計入），影片最多 10 段。

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "保持參考圖中產品的外觀，依參考影片的鏡頭節奏，呈現產品在桌面上緩緩旋轉",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

首尾影格

首影格與尾影格放在 metadata.firstFrame 與 metadata.lastFrame。lastFrame 必須與 firstFrame 同時提供。可靈允許首尾影格與參考圖片一起提交，合計不超過 30 張。

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "鏡頭從清晨的海岸平順推進到傍晚的同一片海灣",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

檔案上傳

也可以用 multipart/form-data 直接上傳 1 個本機圖片檔，欄位名稱為 input_reference；此時不能再同時提交 images 或 image。參考影片無法以檔案形式提交，請先依本機素材上傳取得 URL。

舊模型名稱

先前帶有規格後綴的模型名稱 kling-3.0-turbo-720p、kling-3.0-turbo-1080p、kling-3.0-turbo-2k、kling-3.0-turbo-4k 已於 2026-10-10 下架，使用這些名稱提交會回傳錯誤。請改用 kling-3.0-turbo，並以 resolution 選擇規格。