Kling 3.0

用 Kling 3.0 從文字或首尾影格生成 3–15 秒影片，可選原生音訊、多鏡頭提示詞和可重複使用的主體，以任務形式交付。

Kling 3.0（可靈 3.0）是快手的影片生成模型。一次請求就能從提示詞，或從首影格加上選填的尾影格，生成一段 3–15 秒的影片，有三種品質模式（std、pro、4K），需要時還能生成原生音訊。一段影片也可以由最多五個鏡頭組成，每個鏡頭有自己的提示詞和長度。傳送請求，保存回傳的任務 ID，再從該任務讀取生成完成的影片。圖片以 URL 形式傳入。

模型 ID

模型 ID	輸入	模式	時長
`kling-3-0`	文字、首影格與尾影格、主體	`std`、`pro`、`4K`	3–15 秒

目前價格請查看模型頁面。

快速範例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

端點

POST https://api.seedrouter.ai/v1/videos/generations

請求標頭	值
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

回應是一個任務（{"id": "task_...", "status": "processing"}），而不是生成完成的影片。請輪詢 GET /v1/tasks/{task_id} 取得結果。請把 API 金鑰保存在伺服器端程式碼中。

參數

欄位	類型	預設值	說明
`model`	string	必填	`kling-3-0`
`prompt`	string	單一鏡頭時必填	最多 2,500 個字元。多鏡頭模式下為選填。
`image_urls`	URL 陣列	無	最多 2 張圖片：第一張是首影格，第二張是尾影格。不傳圖片時為文字轉影片。
`mode`	enum	`pro`	`std`、`pro` 或 `4K`（K 大寫）。
`duration`	integer	`5`	3–15 秒。
`aspect_ratio`	enum	`16:9`	`16:9`、`9:16` 或 `1:1`。
`sound`	boolean	`false`	隨影片一起生成原生音訊。
`multi_shots`	boolean	`false`	用 `multi_prompt` 中的鏡頭組成這段影片。
`multi_prompt`	array	無	最多 5 個鏡頭，每個為 `{"prompt", "duration"}`：提示詞最多 500 個字元，長度為 1 到 12 之間的整數秒。`multi_shots` 為 `true` 時必填。
`kling_elements`	array	無	最多 3 個主體，每個為 `{"name", "description", "element_input_urls"}`，附 2–4 個圖片 URL。

請求結構採嚴格驗證：未知欄位會被拒絕，而不是被忽略。不支援 callback_url；請改為輪詢任務。

多鏡頭影片

把 multi_shots 設為 true，並在 multi_prompt 中描述每個鏡頭。各鏡頭長度相加必須在 3–15 秒之間；這個總和就是影片長度，此時不使用 duration。prompt 可以省略，也可以用來寫所有鏡頭共有的內容。

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

主體

主體是模型在整段影片中保持一致的對象：一個人、一件產品或一個角色。給它一個 name、一句簡短的 description 和 2–4 張它的圖片，然後在提示詞中用名字提到它（例如 @hero）。

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

媒體輸入

每張圖片都是一個公開的 HTTP(S) URL。不接受 Base64 data URI：請把檔案上傳到你自己的儲存空間，再傳入它的 URL。請使用不超過 10 MB 的 JPG 或 PNG 圖片。

計費維度

目前費率請查看模型定價部分。Kling 3.0 按影片秒數計費，費率由模式以及是否開啟 sound 決定：

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

計費秒數在請求受理時就已確定，因此預扣金額就是實際扣款金額。最終扣款請在帳戶的用量紀錄中查看。失敗的任務不計費。

輸出結構

提交後回傳任務：

{"id": "task_...", "model": "kling-3-0", "status": "processing", "created_at": 1789689600}

查詢任務

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每 10–20 秒輪詢一次，直到 status 變為 completed 或 failed。輪詢過程中出現網路逾時，並不代表生成失敗：請保留任務 ID 並繼續查詢。不要為了查看進度而再建立一個任務。

完成的任務

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

在我們的測試中，一段 3 秒的 std 影片回傳為 MP4（H.264），解析度 1280 × 720；一段 5 秒、開啟 sound 的 pro 影片解析度為 1920 × 1080，附音軌。每段大約耗時兩到三分鐘。

錯誤

在任務建立之前就被拒絕的請求，會回傳 HTTP 錯誤狀態碼和一個 error 物件，且不計費。受理之後才失敗的任務，在查詢時回傳 HTTP 200，並帶有 status: "failed" 和一個 error 物件。

錯誤碼、HTTP 狀態碼和重試建議請參閱共用錯誤目錄。

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身逾時，請先檢查你的任務清單再重新提交：第一次請求有可能已經被受理。

實用建議

主體、地點、運鏡和光線各用一句話描述；Kling 能理解「slow push-in」（緩慢推近）、「low angle」（低角度）這類鏡頭語言。
先用 std 做草稿，再用同一個請求以 pro 或 4K 算繪最終鏡頭。
用首影格和尾影格控制鏡頭的起點和終點。
用 multi_prompt 把一個場景拆成多個鏡頭，而不是在一條提示詞裡描述好幾次剪接。
加上 no text, no logos，避免出現憑空編造的標記。