可灵模型参数说明

基本请求

{
  "model": "kling-v3-omni",
  "prompt": "写代码，黑客帝国风格",
  "image": "https://example.com/input.png",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "audio_generation": "Enabled"
  }
}

支持的通用字段

字段	类型	说明
`model`	string	系统模型名，例如 `kling-v3-omni`、`kling-v3`
`prompt`	string	视频提示词。
`image`	string	单个输入文件 URL，默认作为参考图。
`images`	string[]	多个输入文件 URL，默认作为参考图。
`size` / `resolution`	string	输出分辨率，例如 `1280x720`、`1920x1080`、`720P`、`1080P`、`2K`、`4K`。
`seconds` / `duration`	string / number	视频时长，单位秒。
`metadata`	object	允许的补充参数，见下文。

`image/images` 默认行为

默认情况下，image / images 默认图片是参考图，不是首帧，也不是参考视频。

`metadata` 支持字段

metadata 用于补充视频生成参数，调用者只需要按业务需要传入系统支持的字段即可。常见字段包括：

字段	含义
`negative_prompt`	负向提示词，指定不想出现的内容。
`enhance_prompt`	提示词增强开关，系统会辅助优化或扩写 prompt。
`aspect_ratio`	画幅比例，例如 `16:9`、`9:16`。
`audio_generation`	是否生成音频。
`enable_bgm`	是否启用背景音乐。
`person_generation`	人物生成策略或模式。
`enhance_switch`	增强开关，用于控制生成增强能力。
`off_peak`	错峰模式，用于低峰策略或低峰计费。
`frame_interpolate`	插帧开关。
`logo_add`	是否添加 Logo。
`last_frame_url`	尾帧图片地址。
`scene_type`	场景类型，用于标识当前任务场景。
`seed`	随机种子。
`category`	输入文件类别，常见值为 `Image` / `Video`。
`usage`	输入用途，常见值为 `Reference` / `FirstFrame`。
`reference_type`	参考类型，例如参考视频的特征模式或基础编辑模式。
`object_id`	主体 ID。
`voice_id`	音色 ID。
`keep_original_sound`	是否保留原声音频。
`text`	主体描述文本。

可灵标准价格表

以下为可灵模型的标准单价，单位为元/秒：

模型	属性	480/540P	720/768P	1080P	2K	4K
Kling 3.0-Omni	无参考视频、无声	-	0.600	0.800	1.000	3.000
Kling 3.0-Omni	无参考视频、有声	-	0.800	1.000	1.200	3.000
Kling 3.0-Omni	有参考视频、无声	-	0.900	1.200	1.500	2.000
Kling 3.0-Omni	有参考视频、有声	-	1.100	1.400	1.800	2.400
Kling 3.0	无声	-	0.600	0.800	1.000	3.000
Kling 3.0	有声+无音色	-	0.900	1.200	1.500	3.000
Kling 3.0	有声+有音色	-	1.100	1.400	1.800	2.400

说明：部分模型不支持某些分辨率时，不会自动降级计费，系统会按支持的档位保守预扣。

常见调用示例

1. 文生视频，1080P，有声

{
  "model": "kling-v3-omni",
  "prompt": "赛博朋克城市夜景，霓虹灯，镜头缓慢推进",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "audio_generation": "Enabled"
  }
}

2. 参考图生视频，1080P，有声

默认图片就是参考图。

{
  "model": "kling-v3-omni",
  "prompt": "让图中的人物在雨夜街头缓慢转身，电影感",
  "image": "https://example.com/person.png",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "audio_generation": "Enabled"
  }
}

3. 首尾帧视频

传入 last_frame_url 时，输入图片会作为首帧，last_frame_url 作为尾帧。

{
  "model": "kling-v3-omni",
  "prompt": "从第一张图自然过渡到第二张图，镜头平滑移动",
  "image": "https://example.com/first.png",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "last_frame_url": "https://example.com/last.png",
    "audio_generation": "Disabled"
  }
}

4. 参考视频

只有当 category=Video 且 usage=Reference 时，才按参考视频场景处理：

{
  "model": "kling-v3-omni",
  "prompt": "参考视频中的人物动作，生成相同风格的视频",
  "image": "https://example.com/reference.mp4",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "category": "Video",
    "usage": "Reference",
    "reference_type": "feature",
    "keep_original_sound": "Disabled",
    "audio_generation": "Enabled"
  }
}

5. 视频编辑

视频编辑可以把 reference_type 设为 base：

{
  "model": "kling-v3-omni",
  "prompt": "把视频风格改成赛博朋克，保留主体动作",
  "image": "https://example.com/base.mp4",
  "size": "1920x1080",
  "seconds": "5",
  "metadata": {
    "category": "Video",
    "usage": "Reference",
    "reference_type": "base"
  }
}

计费说明

系统采用预扣费：

提交任务时预扣。

成功后不补扣。

失败时按现有任务失败逻辑退款。

预扣倍率主要由以下因素决定：

seconds：时长倍率。

size / resolution：分辨率倍率。

metadata.audio_generation / metadata.enable_bgm：是否按有声价格计。

metadata.off_peak：是否按错峰价格计。

输入文件属性：是否按参考视频价格计。

分辨率说明

支持常见写法：

输入	归一化
`1280x720` / `720P`	`720P`
`1920x1080` / `1080P`	`1080P`
`2560x1440` / `2K`	`2K`
`3840x2160` / `4K`	`4K`

如果模型不支持请求的分辨率，会返回参数错误，不会自动降级计费。

基本请求#

支持的通用字段#

image/images 默认行为#

metadata 支持字段#

可灵标准价格表#

常见调用示例#

1. 文生视频，1080P，有声#

2. 参考图生视频，1080P，有声#

3. 首尾帧视频#

4. 参考视频#

5. 视频编辑#

计费说明#

分辨率说明#