Kling 3.0 Turbo

kling-3.0-turbo 支持纯文生视频和首帧图生视频，输出 720p 或 1080p，时长 3–15 秒。适合快速生成横屏、竖屏或方形短视频。

快速了解

项目	支持范围
任务流程	`POST /v1/task/submit` 提交，`GET /v1/task/{task_id}` 查询
视频时长	3–15 秒
清晰度	720p、1080p
画面比例	`1:1`、`16:9`、`9:16`
素材输入	纯文字，或 1 张首帧
音频生成	支持，默认开启

请求使用 Bearer 认证，生成参数统一放在 input 对象中：

Authorization: Bearer $API_KEY

input 参数

字段	类型	必填	说明
`prompt`	string	是	提示词，最多 5000 个字符
`duration`	integer	是	3–15 秒
`aspect_ratio`	string	是	`1:1`、`16:9`、`9:16`
`resolution`	string	是	`720p` 或 `1080p`
`start_frames`	array	否	首帧，只能传 1 张
`images`	array	否	`start_frames` 的兼容别名，只读取第 1 张
`audio`	boolean	否	是否生成带音频视频，默认 `true`
`n`	integer	否	生成数量，当前只支持 `1`

不传 start_frames 即为文生视频。start_frames 用于固定开头画面；images 是兼容别名，只读取第 1 张。本模型不支持 image_references、end_frames、video_references、audio_references。

输出尺寸

aspect_ratio	720p	1080p
`1:1`	`960x960`	`1440x1440`
`16:9`	`1280x720`	`1920x1080`
`9:16`	`720x1280`	`1080x1920`

请求示例

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "input": {
      "prompt": "一只白色机械鸟飞过雨后的城市天际线，镜头缓慢跟随",
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "duration": 6,
      "audio": true
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "input": {
      "prompt": "以这张画面作为首帧，镜头向前推进，城市灯光闪烁",
      "start_frames": [
        "https://example.com/city.jpg"
      ],
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "audio": true
    }
  }'

获取结果

提交成功后保存返回的 id，再用它查询任务：

curl https://cdn.12ai.org/v1/task/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer $API_KEY"

当 status 为 completed 时，从 outputs 读取视频 URL：

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "completed",
  "phase": "completed",
  "outputs": [
    "https://img.12ai.org/videos/task_xxxxxxxxxxxxxxxx_0.mp4"
  ],
  "error": null
}

轮询状态、失败处理和回调格式见异步视频任务。

使用建议

场景	建议
快速文生视频	不传参考素材，用 `prompt` 描述画面、动作和镜头
固定开头画面	使用 1 张 `start_frames`；新接入不必使用兼容字段 `images`
多图参考	改用 `happy-horse-1.1`
首尾帧过渡	改用 Seedance，本模型不支持 `end_frames`
参考视频 / 音频	改用 Seedance 或 `MiniMax-H3`