Kling-v3-omni 传入参考视频

魔芋平台调用 kling-v3-omni 时如何正确传入「参考视频」。

核心结论

参考视频必须放进 metadata，字段名用 videos（数组），且必须关闭音频（generateAudio: false）。

❌ 放在请求顶层的 video / videos 会被 TaskSubmitReq 反序列化静默丢弃——任务能提交成功，但上游收到的是纯文生视频，参考视频不生效。

❌ metadata.video（单数）上游会忽略，参考视频同样不生效。

❌ 带参考视频却开着音频，上游直接报错：
AudioGeneration Enabled is not supported when video reference is provided for model Kling 3.0-Omni

✅ metadata.videos（数组）+ generateAudio: false：实测参考视频真正生效。

原理见：

TaskSubmitReq 无 video/videos 顶层字段 → relay/common/relay_info.go:645

custom 适配器把 metadata.* 整体展开进上游请求体 → relay/channel/task/custom/adaptor.go:235-239

kling-v3 字段白名单保留 videos → relay/channel/task/custom/adaptor.go:291-298

接口地址

用途	方法	地址
提交任务	POST	`https://www.moyu.info/v1/video/generations`
查询结果	GET	`https://www.moyu.info/v1/videos/{task_id}`

提交任务

请求：

响应：

{
  "id": "1426424353-AigcVideoTask-af806fe15e7290261135f670b70f9eb9t",
  "task_id": "1426424353-AigcVideoTask-af806fe15e7290261135f670b70f9eb9t",
  "object": "video",
  "model": "kling-v3-omni",
  "status": "PENDING",
  "progress": 0,
  "created_at": 0
}

查询结果

用返回的 task_id 轮询（建议每 3-5 秒一次，整体耗时约 2-4 分钟）：

处理中：

{
  "id": "1426424353-AigcVideoTask-af806fe15e7290261135f670b70f9eb9t",
  "object": "video",
  "model": "",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1785979449
}

成功（视频地址在 metadata.url）：

{
  "id": "1426424353-AigcVideoTask-af806fe15e7290261135f670b70f9eb9t",
  "object": "video",
  "model": "",
  "status": "completed",
  "progress": 100,
  "created_at": 1785979449,
  "completed_at": 1785979685,
  "metadata": {
    "url": "http://store.vod-qcloud.com/1a168d62vodcq251000800/22fa3fa35001834814737318717/aigcVideoGenFile.mp4"
  }
}

状态流转：PENDING → in_progress → completed。生成视频 URL 取 metadata.url。

参数说明

参数	位置	类型	说明
model	顶层	string	固定 `kling-v3-omni`（参考视频仅该模型支持）
prompt	顶层	string	提示词
metadata.videos	metadata	array	参考视频数组，每项 `{"url": "..."}`
metadata.generateAudio	metadata	bool	传参考视频时必须为 `false`

kling-v3-传入参考视频

Kling-v3-omni 传入参考视频#

核心结论#

接口地址#

提交任务#