跳转到主要内容
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-motion-control",
  "prompt": "A dancer performs graceful movements in a sunlit studio",
  "reference_images": [
    {
      "url": "https://example.com/character.jpg"
    }
  ],
  "reference_videos": [
    {
      "url": "https://example.com/motion-source.mp4"
    }
  ],
  "resolution": "720P",
  "generate_audio": false,
  "extra_params": {
    "character_orientation": "video"
  }
}
'
{
  "task_id": "task_2042864638838083584",
  "model": "kling/kling-v3-motion-control",
  "created_at": "2026-04-21T07: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-motion-control

prompt
string

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

示例:

"A dancer performs graceful movements in a sunlit studio"

resolution
enum<string>
默认值:720P

输出分辨率,默认 720P

可用选项:
720P,
1080P
reference_images
object[]

参考图像,仅支持 1 张。生成视频中的人物、背景等元素均以该图为准。

内容要求

  • 人物比例尽量与参考视频动作比例一致,避免用全身动作驱动半身人物;
  • 人物需清晰露出完整的上半身或全身肢体及头部,避免遮挡;
  • 避免极端朝向(如倒立、平卧),人物占画面比例不宜过低;
  • 支持真实 / 风格化角色(含人物 / 类人动物 / 部分纯动物 / 部分类人肢体比例角色)。

图片要求

  • 格式:jpg / jpeg / png
  • 大小 ≤ 10 MB
  • 宽高尺寸:300px ~ 65536px
  • 宽高比介于 1:2.5 ~ 2.5:1 之间。
Maximum array length: 1
reference_videos
object[]

参考视频,仅支持 1 段。生成视频中的人物动作与该视频保持一致。

内容要求

  • 人物需清晰露出完整的上半身或全身肢体及头部,避免遮挡;
  • 建议上传单人动作视频;多人画面会选取占比最大的人物进行生成;
  • 推荐真人动作,部分风格化 / 类人肢体比例角色可通过;
  • 一镜到底、角色始终在画面内,避免切镜、运镜(否则会被截取);
  • 动作避免过快,相对平稳的动作生成效果更佳。

视频要求

  • 格式:MP4 / MOV
  • 大小 ≤ 100 MB
  • 宽高尺寸(长宽边长均需满足):340px ~ 3850px
  • 时长下限 3s,上限取决于 extra_params.character_orientation
    • video≤ 30s
    • image≤ 10s
  • 仅支持公网 URL,不支持 base64。

如果动作难度高、速度快,模型可能只提取其中的有效动作时长(最短需 3s 连续可用动作即可),生成结果时长可能短于上传时长。

Maximum array length: 1
generate_audio
boolean
默认值:false

是否生成声音,默认 false

extra_params
object

扩展参数。

响应

提交成功(异步模式)

task_id
string

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

示例:

"task_2042864638838083584"

model
string

本次任务使用的模型 ID

示例:

"kling/kling-v3-motion-control"

created_at
string

任务创建时间(ISO 8601)

示例:

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

request_id
string

请求唯一 ID

示例:

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