Claude Opus 5.5 已在 SeedRouter 上線

Video

Kling 4.0 Flash

View Markdown

用文字、參考圖片、參考影片,以及可重複使用的角色或道具主體,生成 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文字、參考圖片、參考影片、主體720p3–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
標頭值
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/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_urlsURL 清單無參考圖片,最多 10 張,依序以 @image_1、@image_2、… 提及。
video_urlsURL 清單無參考影片,最多 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@name7 個主體,其中最多 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必填必填
typeimage(預設)video
image_urls2–4 個視角,第一張為主要視角不接受
video_url不接受一段 3–8 秒的單鏡頭角色影片,最短邊至少 700 像素
tagcharacter、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 rate

input 是參考影片與影片主體的合計時長,無條件進位至整秒。接受請求時會測量時長,因此預留金額就是最終計費金額。範例:以 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。
  • 為重複出場的角色建立一個含兩三個清晰視角的主體,而不是只提供一張參考圖片。
  • 加上「無文字,無標誌」以排除虛構的標誌。

相關