Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称支持的模型:
  • kling-v2-6 - 可灵 v2.6(推荐)
string
必填
正向文本提示词,不能超过 2500 个字符建议详细描述场景、动作、风格等,以获得更好的生成效果示例:"一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感"
string
默认值:"std"
生成模式可选值:
  • std - 标准模式(720P,仅支持无声视频)
  • pro - 专业模式(1080P,支持自动音频生成)
默认值:std
标准模式限制std 模式仅支持无声视频,audio 参数需在 pro 模式下使用。
integer
默认值:"5"
视频时长(秒)可选值:510默认值:5
string
默认值:"16:9"
视频宽高比可选值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
默认值:16:9
string
负面提示词,用于排除不想要的内容示例:"模糊, 低画质, 变形"
array<url>
图片 URL 数组,用于图生视频
  • 1 张:作为首帧图片
  • 2 张:自动分配为首帧 + 尾帧(需 mode: "pro"
最多支持 2 张图片示例:["https://example.com/first.jpg"]
  • 最多支持 2 张图片
  • 首尾帧功能(传 2 张图片)仅支持 pro 模式,std 模式仅支持首帧(1 张图片)
  • 尾帧与音频互斥:在 pro 模式下,尾帧(传 2 张图片)和音频(audio: true)不能同时使用
  • 图生视频时,aspect_ratio 可能被图片实际比例覆盖
boolean
默认值:"false"
是否自动生成音频默认值:false
  • 仅在 mode: "pro" 下可用
  • 与尾帧互斥:开启音频时不能同时使用尾帧(传 2 张图片)
boolean
是否添加水印

功能支持矩阵

注意:在 pro 模式下,尾帧和声音控制不能同时使用,二者互斥。

文生视频 vs 图生视频

系统通过是否传入 image_urls 自动判断模式:不传图片为文生视频,传图片为图生视频。

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:文生视频(标准模式)

场景 2:文生视频(专业模式 + 负面提示词)

场景 3:图生视频(首帧图片)

场景 4:图生视频(首帧 + 尾帧控制)

场景 5:专业模式 + 自动音频

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。