Kling V4 Flash

kling-v4-flash 的 APIMaster 閘道契約，核查日期 2026-11-07。通道 317 支援文字、單首幀圖片、參考、編輯及續寫；統一輸出 720p、24fps、3–20 秒，與 Kling V4 為不同模型。

Kling V4 Flash

介面與認證

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

欄位與限制

使用 JSON 和 Authorization: Bearer YOUR_API_KEY，model 固定 kling-v4-flash。除單首幀圖生外，prompt 均必填。duration/seconds 僅接受 3–20 的 JSON 整數，預設 5；null 視為省略，0 拒絕。兩個別名同時指定時必須有效且相等。編輯省略時長時，將輸入視訊串流時長無條件進位。resolution 僅 720p。aspect_ratio（別名 size）支援 16:9、9:16、1:1、21:9；僅參考模式支援 auto。文字預設 16:9，參考預設 auto，編輯省略則沿用輸入。圖生與續寫拒絕非空 aspect_ratio/size。audio 僅允許 true，watermark 僅 false。

參數	JSON 型別	是否必填	預設值	用途、取值與限制
model	string	必填	kling-v4-flash	固定為 kling-v4-flash，五種操作共用此 ID；kling-v4 是另一個模型。
prompt	string	依模式	—	描述畫面、動作或編輯目標。文生、參考、編輯、續寫必填；僅單首幀圖生可省略。以 @Image1、@Video1 引用素材，各類陣列分別從 1 編號；編輯來源為 @Video1。
duration	integer / null	選填	5	輸出長度為 3–20 的 JSON 整數，通常預設 5 秒。編輯省略時依輸入視訊串流長度向上取整；續寫表示新增片段。null 視為省略；0、非整數數值、字串數字均拒絕，計費使用請求整數秒。
seconds	integer / null	選填	—	duration 的相容別名。建議只傳一個；同時傳入時兩者都須有效且相等，否則回傳 400。
resolution	string	選填	720p	僅支援 720p 輸出檔位，不代表短邊固定為 720px；不支援 1080p 或用 mode 切換畫質。
aspect_ratio	string	選填	依模式	文生、參考、編輯接受 16:9、9:16、1:1、21:9；僅參考支援 auto。預設依序為文生 16:9、參考 auto、編輯跟隨輸入。圖生與續寫拒絕非空值；空字串視為省略。
size	string	選填	—	aspect_ratio 的相容別名，不是解析度或像素尺寸。兩者同傳須相等；首幀圖生與續寫應同時省略。
image_urls	string[]	依模式	—	公開圖片 URL 陣列。自動模式只接受一張首幀；純圖片參考須明確指定 reference。參考/編輯最多 10 張，與角色參考圖合計；圖生不與其他首幀欄位混用，續寫不接受圖片。
first_frame_image	string	依模式	—	唯一首幀的公開 URL；與單個 image_urls 或 first_frame 角色三選一。圖生可省略提示詞。圖片寬高均至少 300px，比例 2:5–5:2；需要時先裁切。
image_with_roles	{url, role}[]	依模式	—	每個物件必含公開圖片 url 與 role。first_frame 用於唯一首幀，reference_image 用於參考/編輯；不支援尾幀、中間幀、關鍵幀。兩個圖片欄位合計最多 10 張參考圖，圖片與影片參考合計最多 15 個。
video_url	string	依模式	—	單一來源影片公開 URL，必須明確指定 edit / extend，與 video_urls 互斥。編輯須 MP4/MOV、串流長度 3–20 秒、寬高各 700–4553px。續寫從最後一幀開始，只回傳新片段；不能傳任務或對話 ID。
video_urls	string[]	依模式	—	參考影片最多 5 段 MP4/MOV，每段串流長度至少 3 秒，寬高各 700–4553px，總長不超過 20 秒。編輯/續寫可指定模式並傳恰好 1 段取代 video_url；超長拒絕而非截取。
omni_reference_task_type	string	選填	auto	auto 依素材選文生/圖生/參考；reference 將圖片當參考並要求素材；edit / extend 要求恰好一段影片。單傳 video_url 無效；自動模式的兩張普通圖片不會自動成為參考。
audio_setting	string	選填	auto	僅支援含影片的參考模式。auto 重新產生聲音；origin 保留第一段影片原聲，無音軌則輸出也無音軌。編輯、續寫、文生、純圖片參考應省略。不是音訊 URL 欄位。
audio	boolean	選填	true	相容布林參數，省略或傳 true；false 拒絕。保留原聲須使用受支援模式的 audio_setting，不支援獨立音訊參考。
watermark	boolean	選填	false	相容布林參數，省略或傳 false；true 拒絕。不是輸入素材去浮水印服務。

素材須為無嵌入認證資訊的公開 HTTP(S) 直連，不接受 base64、本機路徑或任務 ID。上游未另行公布圖片格式/位元組上限。每段被探測的參考/編輯影片最多讀取 100MiB，並非通用上游上傳限制。

模式與素材

生成模式	選擇方式與必要素材	預設行為與限制
文生影片	無圖片/影片；提示詞必填，類型省略或 auto。	5 秒、16:9；無 audio_setting。
首幀圖生影片	三種首幀欄位擇一提供一張圖；提示詞可省略。	5 秒、依圖片比例；省略 aspect_ratio / size，無尾幀。
參考生影片	reference + 圖片，或角色參考圖、video_urls；提示詞必填。	5 秒、auto；圖≤10、影片≤5、總計≤15；有影片才支援聲音選項。
影片編輯	edit + 一段來源影片；提示詞必填，參考圖最多 10 張。	長度向上取整，比例跟隨輸入；無幀角色或 audio_setting。
影片續寫	extend + 一段來源影片；提示詞必填。	新增 5 秒、依來源比例；無圖片、比例覆寫或 audio_setting，不套用編輯/參考最小尺寸與時長檢查。

omni_reference_task_type 為 auto、reference、edit、extend。單張 image_urls、first_frame_image 或一個 first_frame 角色為首幀。多張參考圖需要明確 reference 或 reference_image 角色；auto 下直接給兩張 image_urls 會拒絕。video_urls 預設參考，明確 edit/extend 時使用該模式。video_url 必須指定 edit/extend，且與 video_urls 互斥。編輯及續寫需要一條影片；編輯可附參考圖，續寫不接受圖片/audio_setting，且只回傳新增片段。續作使用公開原影片 URL，不接受任務 ID 或會話 ID。

使用不含認證資訊的公開 HTTP(S) 直連。最多 10 張圖片、圖片與參考影片合計最多 15 個。圖片寬高至少 300 像素，比例 2:5–5:2。參考影片最多 5 條 MP4/MOV，每條至少 3 秒、合計不超過 20 秒。編輯為單條 3–20 秒影片，寬和高分別須在 700–4553 像素。閘道單條探測最多讀取 100 MiB，按視訊軌時長，不按容器或音軌。此最小時長及尺寸檢查不適用於續寫輸入。上游也會檢查圖片尺寸。audio_setting=origin 僅供帶影片參考模式，保留首條參考影片原聲，無音軌則靜音；auto 產生聲音。編輯會重新產生聲音。音訊 URL、尾幀/中間幀、關鍵幀、negative_prompt、mode、seed、多鏡頭及人物/音色清單不支援。

輸出像素與影格率

比例 / 模式	上游公布的輸出像素	影格率
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
首幀圖生影片	依圖片比例，約 0.92MP；2:5 首幀例如 604×1516。	24 fps

輸出尺寸不等於合法輸入尺寸。21:9 輸出高 628px，低於參考/編輯要求的 700px；再次使用時須準備合規素材，續寫不受此最小尺寸檢查。成片可能多約一幀。

不執行生成的範例

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

計費規則

官方名義基礎價為 720P 輸出每秒 $0.094、720P-input 每計費秒 $0.0628。文字、圖生、純圖片參考與續寫按輸出/新增片段秒數。影片參考及編輯按 輸出 + max(輸入, 輸出)：先合計所有輸入視訊軌時長，再對總和無條件進位。例如輸入 3.04 秒、輸出 3 秒，按 3+max(4,3)=7 秒計費。成片多約一幀仍按請求的整數輸出秒數。資源包折扣與帳戶倍率另計，以模型卡及最終消費紀錄為準。已確認的生成失敗退還預扣。停止輪詢不會取消任務；網路逾時受理不明時不可擅自重新生成。

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

輪詢、錯誤與安全重試

首次受理回傳 HTTP 200、公開 task_id 與 queued。GET /v1/videos/{task_id} 查詢 queued/in_progress/completed/failed，容忍暫時 unknown。url 和 metadata.url 需要 Bearer，亦可 GET /v1/videos/{task_id}/content 下載。生成失敗提供 error.code=generation_failed 與去識別化訊息，參數錯誤為 HTTP 400。Idempotency-Key 為 8–128 個可見 ASCII 字元、不可含空格。同帳戶/鍵/請求重放回 HTTP 202，不重複生成或預扣；修改請求為 409。GET /v1/video-submissions/by-key 用原鍵讀取回執。accepted+task_ready=true 時輪詢 task_id，pending/submitting 或未就緒時等待。acceptance_unknown 請保留原鍵聯絡支援，不自動重送；404 不證明未受理。至少保留 30 天，這是閘道保護而非上游查單。最終金額請按 other.task_id 查消費紀錄，輪詢不保證最終帳單。/v1/videos/quote 不支援。範例不執行生成，請換成實際 URL；每次新操作使用新鍵。

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI