跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
通过 POST /api/generate/submit 提交 kwaivgi/kling-v2.6-pro/text-to-video。使用返回的 task_id 调用查询任务状态接口查询结果,或在顶层提供 callback_url。

参数

  • prompt:必填的非空字符串,去除首尾空白后为 1 到 1,000 个字符。
  • duration:必填整数:5 或 10 秒。字符串和小数时长会被拒绝。
  • aspect_ratio:必填:16:9、9:16 或 1:1。控制输出视频的宽高比。
  • sound:必填布尔值:true 生成音频,false 不生成音频。
  • 使用标准 JSON 类型。未知的 input 字段和无效值会在提交和扣费之前被拒绝。
  • 使用 example.com 或 your-domain.com 的 URL 是占位符。请替换为你自己的公开图像 URL 和回调接口(如适用)。

计费因素

计费取决于视频时长(duration)以及是否生成音频(sound)。Pro 文生视频和图生视频接口费率相同。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取 API Key

在请求头中添加:

请求体

application/json
model
string
必填
示例:

"kwaivgi/kling-v2.6-pro/text-to-video"

input
object
必填

生成参数

callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填