Skip to main content
POST
Kling 视频生成

Kling 视频生成

Kling 使用 POST /v1/videos 提交任务,并以 JSON 提交为主。
  • 路由入口是 POST /v1/videos
  • 当前使用 JSON 提交。
  • 支持文生视频、图生视频、首尾帧生视频等多种场景。
  • 通过 metadata 字段传递扩展参数,包括输出配置、场景类型等。
  • 提交成功后返回任务 idstatus,后续用 任务状态查询 轮询结果。

支持模型

  • Kling-3.0-Omni:Kling 3.0 全能版
  • Kling-2.6:Kling 2.6 版本
  • Kling-2.5:Kling 2.5 版本

方法与路径

请求示例

场景示例

文生视频

图生视频

首尾帧生视频

动作控制

响应示例

注意:响应中的 model 字段可能包含计费规格后缀(如 720p-ref-audio),与请求传入的模型名称不同。

认证

Body

string
必填
模型名称。例如 Kling-3.0-OmniKling-2.6Kling-2.5
string
必填
提示词。生成视频的文本描述,支持中文和英文。
string
视频时长。例如 51015
string
视频尺寸。快速尺寸输入,例如 720x1280
string
参考图片。参考图片 URL。
object
元数据。扩展参数容器,建议把上游原生参数都放到 metadata 中。
object
输出配置。建议把原生参数都放到 output_config 中。
  • duration:时长(秒)
  • resolution:分辨率(720P1080P)
  • aspect_ratio:画幅比例(16:99:161:1)
  • audio_generation:音频生成(EnabledDisabled)
string
场景类型。示例:motion_control(动作控制)、avatar_i2v(数字人生成)、lip_sync(对口型)、template_effect(模板特效)。
string
运动等级。示例:std(标准)、pro(专业,用于动作控制计费分档)。
boolean
是否错峰计费。true:错峰生成视频;false:即时生成视频。
string
首尾帧中的尾帧。首尾帧生视频时指定尾帧图片 URL。
string
参考视频 URL。
string
文件信息。原生 FileInfos 透传(高级用法)。
string
扩展信息。原生 ExtInfo 字符串透传(高级用法)。

Response

string
任务 ID。
string
任务 ID(与 id 相同)。
string
固定为 video
string
模型名称。
string
任务状态,常见值包括 queuedprocessingcompletedfailedcancelled
integer
进度百分比(0-100)。
integer
创建时间(Unix 时间戳)。

相关接口