Skip to main content
通过 即刻API 统一网关调用可灵 3.0 Turbo 视频生成接口，使用官方 Kling Turbo 上游协议，支持文生视频和图生视频（仅支持首帧），所有任务均为异步处理。
请传入公网可访问的图片 URL。不要直接传 base64 图片数据；本地图片请先使用上传图片接口获取 URL。
  • 图生视频仅支持首帧，reference_images 中只有第一张图片会被用作首帧
  • 当前接入不支持尾帧，多余图片不会传给上游
  • aspect_ratio 仅对文生视频生效

​
请求参数

​
model
string
required
视频生成模型名称，固定为 kling-3.0-turbo。
​
prompt
string
required
视频提示词。对于图生视频，该字段会转换为 Kling Turbo contents 中的 prompt 项。
​
reference_images
string[]
可选输入图片 URL 数组。Kling Turbo 图生视频只会取第一张图作为首帧。
​
resolution
string
default:"720p"
视频分辨率。支持值：
  • 720p — 默认
  • 1080p
​
duration
integer
default:"5"
视频时长，单位秒。支持值：3、4、5、6、7、8、9、10、11、12、13、14、15。
​
aspect_ratio
string
default:"16:9"
文生视频宽高比（图生视频中此参数无效）。支持值：
  • 16:9（默认）
  • 9:16
  • 1:1
​
watermark
boolean
default:"false"
是否添加官方 Kling 水印。

​
请求示例

curl --request POST \
  --url https://geekapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "A cinematic shot of a red sports car driving through rain",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

​
返回示例

200
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "kling-3.0-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

​
响应字段

字段类型说明
idstring任务唯一标识符，用于查询任务状态
objectstring对象类型，固定为 generation.task
modelstring使用的模型名称
statusstring任务状态：queued / in_progress / completed / failed
progressinteger任务进度百分比（0–100）
created_atinteger任务创建时间戳（Unix 时间戳）

​
查询任务状态

提交后，使用以下接口轮询任务进度： 
GET https://geekapis.com/v1/videos/generations/{task_id}