kling-3.0-omni API

使用準確的型號 ID kling-3.0-omni。模型欄位必須與此頁面完全相符。

範例輸出kling-3.0-omniPOST /v1/videos5.0s

參數： duration=5resolution=1080pratio=16:9

提示詞： One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

產生此樣本的請求

{
  "model": "kling-3.0-omni",
  "prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

身份驗證與端點

將 Modelflare API 金鑰與 https://modelflare.dev/v1 結合使用。網關入口點是POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

創建任務

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

投票及下載

儲存任務ID。輪詢 GET /v1/videos/{task_id} 並使用 GET /v1/videos/{task_id}/content 下載。結果 URL 可能會過期，因此請立即傳輸檔案。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

請求備註

Kling 使用系列特定的 model_name、prompt、mode、duration、image_list 或 contents / settings 欄位；本機 JSON 保留並轉送。

請求參數

Kling Omni/O1 使用 model_name、prompt 和媒體清單。組合image_list、video_list、element_list、multi_shot和sound時請遵循每個模型的官方限制。

場	必填	註釋
model_name	是	kling-3.0-omni
prompt	有條件	停用連拍時需要
mode	否	std / pro
aspect_ratio	有條件	16:9 / 9:16 / 1:1
duration	否	3–15 秒（字串）
image_list	否	第一/結束畫面、場景或風格參考； Omni/O1 允許型號限制內的多個項目
video_list	否	影片編輯或風格參考
element_list	否	Kling 元素 ID；此整合不提供元素管理
multi_shot	否	啟用多鏡頭故事板
sound	否	是否產生同步聲音

輸入與輸出限制

Omni 支援 720p/1080p/4k、3–15 秒、影像/影片/元素參考以及最多 6 個故事板鏡頭。當存在參考影片時，將 sound 設定為關閉。

記錄的工作流程範例

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

參考影片、元素和多鏡頭組合必須遵循本頁的限制；當存在參考影片時關閉 sound。

錯誤與失敗的任務

無效模型參數傳回帶有請求 ID 的 4xx。非同步任務建立成功後也可能進入失敗；使用輪詢回應中的 error_code 和 error_message 作為最終任務原因。不要使用不同的 JSON 形狀重試相同的請求。

支援範圍

此頁面涵蓋 Modelflare 模型產生和編輯呼叫。搜尋或地圖豐富、語音管理和元素庫管理是此公共模型呼叫表面之外的資源 API，並且不是必需的請求欄位。

定價與計費

此模型採用按秒視訊計費。請參閱 型號定價頁面 ，以了解當前客戶價格、參考標價和完整規格。

注意

此頁面記錄了 Modelflare 的公共介面；此處顯示的欄位和限制是目前合約。