跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
使用 Kling 2.6 Standard 将参考视频中的动作迁移到图片主体上,支持朝向控制,输出 720p。

模型

  • kwaivgi/kling-v2.6-std/motion-control - 将参考视频中的动作迁移到参考图中的角色上。

功能

  • 将参考视频中的动作迁移到参考图中的角色上。
  • 该 model ID 的输出分辨率固定为 720p。

时长选项

  • Image 朝向 - character_orientation 为 image 时,参考视频必须为 3-10 秒。
  • Video 朝向 - character_orientation 为 video 时,参考视频必须为 3-30 秒。
  • 服务会检测参考视频的时长。

高级参数

model 和可选的 callback_url 放在请求根级。下列参数放在 input 中。 只发送该工作流程支持的 input 字段。不支持的 input 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)、包含主机名,且不含内嵌凭据。

提示词

  • prompt 可选。null、空字符串和仅含空白的值视为省略。
  • 非空提示词会去除首尾空白,最多 2,500 个字符。

图像 URL

  • image_urls:必填。恰好提供 1 个图像 URL。
  • 该图片提供动作迁移的目标角色。
  • 图片必须可公开访问且能直接下载。

源视频

  • video_urls:必填。提供一个数组,其中恰好包含一个公开可访问的源视频 URL。
  • 该视频提供要迁移的动作,时长必须符合上述朝向限制。
  • 源视频必须可通过 HTTP(S) 直接下载,且不超过 100 MiB,以便检测时长。

角色朝向

  • character_orientation 必填:选择 image 或 video。
  • image 允许 3 到 10 秒的参考视频。
  • video 允许 3 到 30 秒的参考视频。

分辨率

  • resolution:720p。默认值:720p。
  • 该 model ID 固定了分辨率。省略该字段即使用默认值;传入另一档位的分辨率会被拒绝。

价格

积分按检测到的参考视频时长乘以该接口费率计算,然后向上取整为整数积分。 当前费率请查看 Vidgo 仪表盘。 提交时扣除积分,任务失败时退还。

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和 callback_url 放在根级。未知的根级字段会被忽略;不支持的 input 字段会被拒绝。

model
string
必填
示例:

"kwaivgi/kling-v2.6-std/motion-control"

input
object
必填
callback_url
string | null

可选的公开 HTTP(S) 接口,用于接收任务完成通知。建议使用 HTTPS。省略、传 null 或空字符串即可禁用回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填