Video
Kling 4.0 Flash
用文字、參考圖片、參考影片,以及可重複使用的角色或道具主體,生成 3–20 秒、720p、附帶聲音的 Kling 4.0 Flash 影片。
Kling 4.0 Flash 是快手的 Kling 4.0 家族中的輕量模型。在 SeedRouter 上,它支援文字轉影片和參考生成:最多 10 張參考圖片、5 段參考影片和 7 個主體(以 2–4 張圖片或一段短片建立的具名對象),均需在提示詞中提及。每段影片長 3–20 秒,解析度為 720p,附帶聲音。提交請求、保留回傳的任務 ID,再從任務中讀取完成的影片。媒體以 URL 形式傳入。
模型 ID
| 模型 ID | 輸入 | 解析度 | 時長 |
|---|---|---|---|
kling-4-0-flash | 文字、參考圖片、參考影片、主體 | 720p | 3–20 秒 |
查看模型頁面了解目前價格。
快速範例
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-4-0-flash",
"prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
"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 | 字串 | 必填 | kling-4-0-flash |
prompt | 字串 | 必填 | 最多 8,000 個字元。以 @image_1、@video_1 或 @<element name> 提及素材(見「提及素材」)。 |
duration | 整數 | 5 | 輸出時長 3–20 秒。 |
resolution | 列舉 | 720p | 僅支援 720p 輸出。 |
aspect_ratio | 列舉 | 依輸入 | auto、16:9、9:16、1:1、21:9。省略時:有提供任何參考素材則為 auto,否則為 16:9。 |
image_urls | URL 清單 | 無 | 參考圖片,最多 10 張,依序以 @image_1、@image_2、… 提及。 |
video_urls | URL 清單 | 無 | 參考影片,最多 5 段,以 @video_1、@video_2、… 提及。按影片輸入費率計費。 |
keep_original_sound | 布林值 | false | 保留參考影片本身的音訊。僅在有 video_urls 時生效;沒有參考影片時,一律為生成的影片配上新聲音。 |
elements | 物件清單 | 無 | 本次請求的主體,最多 7 個,以 @name 提及(見「主體」)。 |
每段影片都附帶聲音,沒有聲音開關。沒有首影格、中間影格或末影格欄位,也沒有 negative_prompt、watermark 或獨立的 voices 欄位:請以 voice_url 為主體綁定聲音。結構描述嚴格:未知欄位會被拒絕,而非忽略。不支援 callback_url;請改為輪詢任務。
提及素材
你傳送的每種素材都是選用的;沒有素材時,請求就是純文字轉影片。傳送素材後,請在提示詞中指明它們:
| 素材 | 提及方式 | 限制 |
|---|---|---|
image_urls | @image_1、@image_2、… | 10 張圖片 |
video_urls | @video_1、@video_2、… | 5 段影片 |
elements | @name | 7 個主體,其中最多 3 個為影片主體 |
每個後接字母、數字、底線或中文字元的 @,都必須指向本次請求中的一個素材,否則請求會在扣費前被拒絕。名稱依最長優先比對,不區分大小寫。以字母、數字或底線結尾的名稱,後面不能緊接另一個字母、數字或底線:只提供一張圖片時,@image_12 會被拒絕;請寫成 @image_1 2 或 @image_1,。
參考影片與影片主體合計最多 5 個,圖片、影片和主體合計最多 15 個。
{
"model": "kling-4-0-flash",
"prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
"image_urls": ["https://example.com/dancer.png"],
"video_urls": ["https://example.com/routine.mp4"],
"keep_original_sound": false,
"duration": 8
}主體
主體是可在提示詞中重複使用的具名對象,分為兩種:
| 欄位 | 圖片主體 | 影片主體 |
|---|---|---|
name | 必填 | 必填 |
type | image(預設) | video |
image_urls | 2–4 個視角,第一張為主要視角 | 不接受 |
video_url | 不接受 | 一段 3–8 秒的單鏡頭角色影片,最短邊至少 700 像素 |
tag | character、animal、prop、costume、scene、effect 或 others;省略時自動推斷 | 僅 character |
description | 最多 100 個字元 | 最多 100 個字元 |
voice_url | 參考音訊;僅限角色(tag 為 character 或未填寫) | 參考音訊;省略時使用影片本身的語音 |
名稱由 1–20 個字母、數字、底線或中文字元組成,不區分大小寫且不可重複。image_N、video_N、keyframe_N、object_N、audio_N、first_frame 和 last_frame 為保留名稱。
{
"model": "kling-4-0-flash",
"prompt": "@Mira opens the shop door and greets the morning crowd",
"elements": [
{
"name": "Mira",
"image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
"tag": "character",
"description": "baker in a flour-dusted apron"
}
],
"aspect_ratio": "9:16",
"duration": 6
}媒體輸入
圖片、影片和音訊是公開的 HTTP(S) URL。不接受 Base64 資料 URI:將檔案上傳到你自己的儲存空間,再傳入其 URL。參考影片和影片主體的總時長必須為 2–20 秒;接受請求時會讀取時長,無法讀取時長的影片會在扣費前被拒絕。
費用維度
查看模型費率部分了解目前費率。Kling 4.0 Flash 按 720p 影片秒數計費:
text, reference images, image elements: cost = duration × standard rate
reference videos or video elements: cost = (output + max(output, input)) × video-input rateinput 是參考影片與影片主體的合計時長,無條件進位至整秒。接受請求時會測量時長,因此預留金額就是最終計費金額。範例:以 7.2 秒參考影片引導生成 5 秒影片,按 5 + 8 = 13 秒計費;若參考影片為 3 秒,則按 5 + 5 = 10 秒計費。失敗的任務不計費。
輸出結構
提交後回傳任務:
{"id": "task_...", "model": "kling-4-0-flash", "status": "processing", "created_at": 1789689600}取得任務
GET https://api.seedrouter.ai/v1/tasks/{task_id}每 10–20 秒輪詢一次,直到 status 為 completed 或 failed。輪詢期間的網路逾時不表示生成失敗:保留任務 ID 並繼續檢查。不要建立另一個任務來檢查進度。
完成的任務
{
"id": "task_...",
"model": "kling-4-0-flash",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689800,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}在我們的測試中,5 秒影片於提交後 91–103 秒回傳,格式為 MP4(H.264)、解析度為 1280 × 720,並附帶立體聲 AAC 音軌;檔案時長比 duration 約多一個影格(設為 5 秒時,檔案為 5.04 秒)。
錯誤
在建立任務之前被拒絕的請求會回傳 HTTP 錯誤與 error 物件,且不計費。任務在接受後失敗時,查詢會回傳 HTTP 200,並帶有 status: "failed" 和 error 物件。
查看共享錯誤目錄了解代碼、HTTP 狀態和重試指南。
{
"id": "task_...",
"model": "kling-4-0-flash",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}如果提交本身逾時,在重新提交之前檢查你的任務:第一個請求可能已被接受。
秘訣
- 描述主體、地點、運鏡、光線和聲音;影片的音訊會跟隨提示詞。
- 用 Flash 低成本測試提示詞、寬高比和參考素材;需要 1080p、關鍵影格、編輯或延伸時,再把效果好的鏡頭交給 Kling 4.0。
- 為重複出場的角色建立一個含兩三個清晰視角的主體,而不是只提供一張參考圖片。
- 加上「無文字,無標誌」以排除虛構的標誌。
