Kling v4 Flash 影片生成 | ToAPIs Documentation

POST

/v1/videos/generations

三種輸入模式統一使用 kling-4.0-flash, 依實際素材自動選擇生成方式. 此為非同步任務介面, 提交後使用平台傳回的任務 ID 查詢結果.

使用平台 API Key. 中國大陸使用者可將 https://toapis.com 換成 https://toapis.cn. 可用性依部署後的渠道設定與帳戶權限而定.

輸入模式

模式	請求內容
文字生成影片	僅傳送提示詞與生成規格, 不傳素材.
參考素材	使用 `image_urls` / `video_urls` 或 reference 角色素材. 圖片與影片可以組合.
首影格	在 `image_with_roles` 指定 1 張 `first_frame` 圖片. 不可同時傳參考圖片或影片, 不支援中間與尾影格.

請求參數

Authorizationstring請求頭必填

使用 Bearer YOUR_API_KEY 驗證.

modelstring請求體必填

固定為 kling-4.0-flash. 三種模式不需切換模型 ID.

promptstring請求體必填

必填且不可為空白, 最多 8000 個 Unicode 字元. 描述主體, 動作, 鏡頭與素材關係.

durationinteger請求體預設值: 5

整數, 3-20 秒, 預設 5 秒.

resolutionstring請求體預設值: 720p

僅支援 720p, 預設 720p.

aspect_ratiostring請求體

支援 auto, 16:9, 9:16, 1:1, 21:9. 省略時保留上游預設值; 自動比例可明確傳 auto.

image_urlsstring[]請求體

參考圖片 URL 陣列, 最多 10 張. 不依位置推斷首影格. 與 reference 圖片角色合計數量, 同一素材建議只用一種寫法.

video_urlsstring[]請求體

參考影片 URL 陣列, 與 video_with_roles 合計最多 5 個.

image_with_rolesobject[]請求體

物件欄位為 url 與 role. reference / reference_image 為參考圖; first_frame 為首影格. 不支援 keyframe 與 last_frame.

video_with_rolesobject[]請求體

物件欄位為 url 與 role. 支援 reference / reference_video.

metadataobject請求體

布林值 keep_original_sound 控制保留參考影片原聲, 如 {"keep_original_sound": true}. 僅用於參考影片. 首影格模式不可帶此鍵, 即使為 false.

client_business_idstring請求體

選填的客戶業務 ID, 隨任務儲存, 可透過相同介面查詢.

素材規則與錯誤邊界

使用公開可存取的 HTTP(S) URL, 不可包含使用者名稱或密碼. 本機檔案先透過上傳圖片或上傳影片取得 URL. 不直接傳本機路徑或 base64.
參考模式最多 10 張圖片與 5 個影片. 一般陣列與明確 reference 角色合併計算, 不重複提交相同素材.
首影格模式只接受 1 張 first_frame 圖片, keyframe 與 last_frame 會被拒絕. 首影格依角色判定, 一般圖片陣列不自動視為首影格.
首影格與參考素材互斥. 不使用舊 Kling 的 mode, audio, video_list 或 Omni 引用結構. 不支援 audio_with_roles, metadata.elements, metadata.voices.
非法規格, 角色, URL, 數量或模式組合會被拒絕. 修正錯誤後再提交. 本頁未承諾檔案大小, 編碼或輸入影片時長上限, 仍須符合上傳服務及上游要求.

請求範例

文字生成影片

{
  "model": "kling-4.0-flash",
  "prompt": "海浪拍打海岸, 鏡頭緩慢推進, 日落光線",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

參考素材

{
  "model": "kling-4.0-flash",
  "prompt": "保持參考圖片的人物外觀, 參考影片中的鏡頭運動",
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/character.png"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "metadata": {
    "keep_original_sound": true
  }
}

首影格

{
  "model": "kling-4.0-flash",
  "prompt": "以首影格為起點, 人物緩慢轉向窗外",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_with_roles": [
    {
      "url": "https://example.com/first.png",
      "role": "first_frame"
    }
  ]
}

提交任務

請求示例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-4.0-flash",
  "prompt": "海浪拍打海岸, 鏡頭緩慢推進, 日落光線",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

響應示例

{
  "id": "task_example",
  "object": "generation.task",
  "model": "kling-4.0-flash",
  "status": "queued",
  "created_at": 1792713600
}

查詢任務與計費

回應 id 為平台任務 ID, 使用下方介面查詢, 不使用供應商 task_id. 狀態包括 queued, in_progress, completed, failed. 詳見影片任務狀態及任務 Webhook.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

預設為 5 秒 / 720p, 可明確傳入以控制規格. 本頁不提供固定價格, 亦不將原聲開關等同舊版 Sound 計費; 實際費用依帳戶報價及任務 usage / billing 為準.