跳转到主要内容
POST
/
v1
/
videos
/
generate
curl --request POST \
  --url https://openapi.imini.ai/imini/router/v1/videos/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling/kling-v3-omni",
  "prompt": "A slow pan across a misty mountain valley at sunrise, cinematic",
  "resolution": "720P",
  "aspect_ratio": "16:9",
  "duration": 5
}
'
{
  "task_id": "task_2042864638838083584",
  "model": "kling/kling-v3-omni",
  "created_at": "2026-04-13T07:17:39.146Z",
  "request_id": "291a4117-9df8-4349-aee1-bdf8ffcacb9a"
}

授权

Authorization
string
header
必填

在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。前往 API Keys 管理页 创建和管理 API Key。

请求体

application/json
model
string
必填

固定值 kling/kling-v3-omni

prompt
string

提示词,可包含正向与负向描述,长度不超过 2500 字符。

Omni 模型支持在提示词中通过 <<<>>> 语法引用主体、图片、视频等素材,例如:<<<element_1>>><<<image_1>>><<<video_1>>>

必填规则

  • extra_params.multi_shot=false,或 extra_params.multi_shot=trueextra_params.shot_type=intelligence 时,本字段不得为空;
  • extra_params.multi_shot=trueextra_params.shot_type=customize 时,本字段被忽略,各分镜提示词由 extra_params.multi_prompt 提供。
示例:

"A slow pan across a misty mountain valley at sunrise, cinematic"

resolution
enum<string>
默认值:720P

输出分辨率,默认 720P

可用选项:
720P,
1080P
aspect_ratio
enum<string>
默认值:16:9

输出宽高比,默认 16:9

可用选项:
16:9,
9:16,
1:1
duration
enum<integer>
默认值:5

视频时长(秒),默认 5。枚举值:3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

使用视频编辑功能(reference_videos[].refer_type=base)时,本参数无效——输出时长与输入视频一致,按输入视频时长四舍五入取整计费。

可用选项:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
generate_audio
boolean
默认值:false

是否生成声音,默认 false

reference_images
object[]

参考图列表。可作为主体 / 场景 / 风格参考,也可作为视频首帧或尾帧。

输入模式(由 reference_type 组合决定):

  • 图生视频:1 张 first_frame
  • 首尾帧生视频:1 张 first_frame + 1 张 last_frame(暂不支持仅尾帧——传入 last_frame 时必须同时提供 first_frame);
  • 多参考图生视频:N 张 asset(非首尾帧的素材可省略 reference_type,默认即为 asset)。

reference_videos 的组合规则

  • 传入 reference_videos[].refer_type=base(待编辑视频)时,reference_images 不可使用 first_frame / last_frame,仅支持 asset
  • 其他情况下 asset 类型可与 reference_videos 共存。

图片要求

  • 格式:jpg / jpeg / png
  • 大小 ≤ 10 MB
  • 宽高尺寸 ≥ 300px,宽高比介于 1:2.5 ~ 2.5:1 之间。

数量上限("参考图 + 多图主体" 总数):

  • 无参考视频,仅含多图主体:≤ 7
  • 无参考视频,含视频主体:≤ 4
  • 有参考视频,仅含多图主体:≤ 4
reference_videos
object[]

参考视频列表。至多 1 段。

两种用途(由 refer_type 区分):

  • base(默认)— 待编辑视频,对原视频直接重绘/编辑;此模式下不能再通过 reference_images 指定 first_frame / last_frame
  • feature特征参考视频,仅提取运动/风格等特征辅助生成。

通过 keep_original_sound 选择是否保留原视频音轨——该参数对 feature 同样生效。

传入参考视频时,generate_audio 将被强制视为 false(不会额外生成音频)。

视频要求

  • 格式:MP4 / MOV
  • 大小 ≤ 200 MB
  • 时长 ≥ 3s(上限随模型版本而定);
  • 宽高尺寸:720px ~ 2160px(含);
  • 帧率:24 ~ 60 fps(输出统一为 24 fps);
  • 仅支持公网可访问 URL,不支持 base64。
Maximum array length: 1
extra_params
object

可灵官方扩展参数,全部选填。

响应

提交成功(异步模式)

task_id
string

任务唯一 ID,用于后续轮询查询

示例:

"task_2042864638838083584"

model
string

本次任务使用的模型 ID

示例:

"kling/kling-v3-omni"

created_at
string

任务创建时间(ISO 8601)

示例:

"2026-04-13T07:17:39.146Z"

request_id
string

请求唯一 ID

示例:

"291a4117-9df8-4349-aee1-bdf8ffcacb9a"