Kling Video V4 API

支援文生、首尾幀圖生及參考影片的多模態影片模型。

POST /v1/videos/generations

文生、首尾幀圖生與參考影片生成,支援非同步提交和任務查詢。

文生视频

必填参数: model

可用参数: model, prompt, contents, settings, options, wait, nonce

首尾帧图生

必填参数: model

可用参数: model, prompt, contents, settings, options, wait, nonce

参考视频

必填参数: model

可用参数: model, prompt, contents, settings, options, wait, nonce

请求参数

参数类型必填说明
modelstring是固定模型名称 可选: kling-video-v4
promptstring否顶层提示词;contents内的prompt文本优先
contentsarray否图生与参考生素材列表,限制见下方详情
settingsobject否可选生成设置;提供后整体优先于顶层兼容字段
optionsobject否通用选项
waitboolean否默认false,推荐提交后查询同一任务
noncestring否同一业务请求使用同一且唯一的幂等标识
生成失败时,任务查询仍返回任务对象;请检查顶层status和error。临时结果地址请及时保存。

请求示例

curl --request POST 'https://api.router.ai/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-binary '{
    "model": "kling-video-v4",
    "prompt": "A fictional blue paper cube rotates slowly on a white table.",
    "settings": {"resolution": "1080p", "duration": 3, "aspect_ratio": "16:9"},
    "wait": false,
    "nonce": "EXAMPLE_KLING_V4_TEXT_001"
  }'

接口通用说明: 提交影片任務