Skip to main content
通过 即刻API 统一网关调用可灵 v3 Omni 视频生成接口，支持官方 Omni 输入结构（image_list、video_list、element_list），可在 prompt 中通过占位符精确引用素材，所有任务均为异步处理。
请传入公网可访问的图片或视频 URL。不要直接传 base64 数据；本地图片请先使用上传图片接口获取 URL。

​
请求参数

​
model
string
required
视频生成模型名称，固定为 kling-v3-omni。
​
prompt
string
required
视频提示词。可使用官方占位符引用 Omni 输入，编号从 1 开始：
  • <<<image_N>>> — 引用 metadata.image_list 中第 N 张图片
  • <<<video_N>>> — 引用 video_list 中第 N 段视频
  • <<<element_N>>> — 引用 metadata.element_list 中第 N 个主体/角色
示例："让<<<image_1>>>中的人物向镜头挥手"引用列表顺序必须与 prompt 中的占位符顺序一致；系统不会自动补首帧或自动插入占位符。
​
client_business_id
string
客户侧业务 ID，例如订单号、流水号或您系统内的任务 ID。提交后会随任务保存，后续可用该 ID 查询状态：GET /v1/videos/generations/{client_business_id}。
​
mode
string
default:"std"
生成模式，同时决定计费分辨率。
  • std — 标准模式，720P
  • pro — 专业模式，1080P
​
duration
integer
default:"5"
视频时长，单位秒。可选值：3–15。
​
aspect_ratio
string
default:"16:9"
视频宽高比。常用值：16:9、9:16、1:1。
​
audio
boolean
default:"false"
是否生成有声视频。
  • false — 普通视频（默认）
  • true — 有声视频，按 Sound 价格计费
​
audio
boolean
default:"false"
audio 与 video_list 互斥。 传入 video_list 时不要同时传 audio=true。
​
video_list
object[]
参考视频列表，最多 1 段视频。传入后按 Video 价格计费。
​
metadata.image_list
object[]
官方 Omni 图片列表。在 prompt 中通过 <<<image_1>>>、<<<image_2>>> 按顺序引用。
​
metadata.element_list
object[]
官方 Omni 主体/角色引用列表。在 prompt 中通过 <<<element_1>>>、<<<element_2>>> 按顺序引用。
​
metadata.watermark
boolean
是否添加水印。

​
Omni 引用语法

语法说明
<<<image_1>>>引用 metadata.image_list 第 1 张图片
<<<video_1>>>引用 video_list 第 1 段视频
<<<element_1>>>引用 metadata.element_list 第 1 个主体/角色

​
计费映射

请求参数计费规格
mode=std，无 audio/video_list720P
mode=pro，无 audio/video_list1080P
mode=std，audio=true720P+Sound
mode=pro，audio=true1080P+Sound
mode=std，有 video_list720P+Video
mode=pro，有 video_list1080P+Video

​
请求示例

curl --request POST \
  --url https://geekapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v3-omni",
    "prompt": "一只金毛犬在沙滩上奔跑，日落，电影质感",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

​
返回示例

200
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "client_business_id": "order_20260428_001",
  "object": "generation.task",
  "model": "kling-v3-omni",
  "status": "queued",
  "created_at": 1768380224
}

​
响应字段

字段类型说明
idstring任务 ID，用于查询任务状态
client_business_idstring客户侧业务 ID（仅当请求中传入时返回）
objectstring对象类型，通常为 generation.task
modelstring本次请求使用的模型名称
statusstring任务状态：queued / in_progress / completed / failed
created_atinteger任务创建时间戳

​
查询任务状态

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