Kling v3 Motion Control 视频生成

通过 APIMaster 调用 Kling 动作控制模型 kling-v3-motion-control：上传参考图片与参考视频，让生成结果跟随参考视频中的动作，可选提示词补充镜头与风格。

Base URL：https://apimaster.ai/v1 即 https://apimaster.ai/v1。路径写 https://apimaster.ai/v1/videos/...，不要再拼一层 /v1。

价格（按参考视频秒数计费）

重要： Kling Motion Control 按模型处理的动作参考视频的计费时长收费，不会因为最终生成视频更短而按输出时长重新结算。

如果模型只成功提取了部分有效动作，导致输出视频比参考视频短，已消耗的额度不会因此退还，也不会按较短的输出时长重新计算。

以下展示供应商参考价应用 0.80 价格倍率（8 折） 后的示例价格，不代表所有账号的固定单价。当前在售渠道与价格见实时模型卡，实际费用还可能受账号分组影响。

模式	供应商参考价	APIMaster 折后价格示例
std（720P 标准）	$0.1286 / 参考视频秒	$0.10288 / 参考视频秒
pro（高质量）	$0.1714 / 参考视频秒	$0.13712 / 参考视频秒

预估费用

参考视频计费时长 × 每参考视频秒单价

例如：参考视频 29 秒，STD 有效单价 $0.10288 / 参考视频秒：

29 × $0.10288 = $2.98352，即使最终生成视频约 3 秒，也不改按 3 秒计算。

供应商参考金额为 29 × $0.1286 = $3.7294；应用示例 0.80 折扣后为 $3.7294 × 0.80 = $2.98352。此示例假设没有额外的账号分组倍率。

计费规则（Billing Rules）

Kling Motion Control 采用按秒计费。APIMaster 的计费秒数对应模型实际处理的动作参考视频。服务端探测 video_url 的时长，并结合上游计费数据完成结算。

生成视频通常与参考视频时长接近。但动作复杂、过快或有效连续动作不足时，模型可能只生成较短的片段。已消耗的额度不会仅因输出变短而退还，也不会改按输出时长重新结算。

结算费用 = 参考视频计费时长 × 每参考视频秒有效单价。

duration 表示预估计费时长，不是要求生成的视频长度，也不能限制最终费用。可以省略此字段。它仅用于估算或预扣费，最终结算以服务端探测的实际参考视频时长及上游计费数据为准。提交预估会将参考时长四舍五入至整秒；探测不可用时，服务端可采用客户端预估值或朝向对应的上限（10 或 30 秒）预扣。

Motion Control 体验页 会在浏览器支持时自动读取参考视频元数据，展示检测时长与预估费用。浏览器检测仅供估算，最终以服务端结算为准。检测失败时可选填预估值或留空。上传前裁短参考视频会改变实际处理的输入；生成结果变短不会改变此前处理的输入。

官方计费参考（Official Billing Reference）

APIMaster 不重新定义底层模型的基本计费结构。定价通常沿用官方/供应商计费逻辑，通过降低有效单价提供折扣，计费单位和基本逻辑保持一致。

Kling 官方指南明确按秒收费；其中动作参考视频的说明也提到，动作提取可能使输出变短，此时已消耗的 Credits 不退款。这些官方说明与 APIMaster 的实现口径应分别理解：APIMaster 及上游按实际处理的参考视频时长结算，不能把官方说明扩大成“所有名为 duration 的字段都必然代表参考视频计费时长”。

• Kling Motion Control 官方使用指南
• Kling Motion Control 官方 API 文档（legacy）

提交任务

POST https://apimaster.ai/v1/videos/generations

字段	类型	必填	说明
model	string	是	固定 kling-v3-motion-control
image_url	string	是	参考图片公网 URL
video_url	string	是	动作参考视频公网直链（建议 mp4/mov，≤100MB）。服务端探测其实际时长，将该参考视频时长用于 Motion Control 结算，而非采用输出视频时长。
character_orientation	string	是	image（参考图朝向，视频 3–10s）或 video（参考视频朝向，3–30s）
mode	string	是	std 或 pro
prompt	string	否	补充动作、镜头、风格
keep_original_sound	string	否	yes（默认）/ no
watermark_info	object	否	如 {"enabled": false}
duration	integer	否	预估计费时长（秒），可省略；仅用于估算或预扣费。最终按服务端探测的参考视频时长及上游计费数据结算，不控制输出长度，也不限制最终费用。

以下示例使用 29 秒参考视频和 video 朝向（允许 3–30 秒），特意省略 duration，由服务端探测参考时长。

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-motion-control",
    "prompt": "保持人物面部特征一致，按参考视频完成转身挥手动作，电影感光影",
    "image_url": "https://example.com/ref-image.png",
    "video_url": "https://example.com/ref-video-29s.mp4",
    "keep_original_sound": "yes",
    "character_orientation": "video",
    "mode": "std",
    "watermark_info": {"enabled": false}
  }'

提交响应

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxx"
    }
  ]
}

参考视频时长规则

character_orientation	允许的参考视频时长
image	3s ~ 10s
video	3s ~ 30s

查询任务

GET https://apimaster.ai/v1/videos/{task_id}

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

完成示例：

{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "url": "https://..."
}

若返回 url 为 APIMaster 代理地址，也可使用 GET https://apimaster.ai/v1/videos/{task_id}/content 下载 MP4。

使用场景示例

image 朝向（10 秒内）

{
  "model": "kling-v3-motion-control",
  "prompt": "保持人物朝向与参考图一致，完成转身和挥手动作",
  "image_url": "https://example.com/ref-image.png",
  "video_url": "https://example.com/ref-video-8s.mp4",
  "character_orientation": "image",
  "mode": "std",
  "keep_original_sound": "yes"
}

video 朝向 + pro 模式

{
  "model": "kling-v3-motion-control",
  "prompt": "跟随参考视频的人物朝向和节奏，保持动作连贯",
  "image_url": "https://example.com/ref-image.png",
  "video_url": "https://example.com/ref-video-12s.mp4",
  "character_orientation": "video",
  "mode": "pro",
  "keep_original_sound": "no"
}

错误码

HTTP	说明
400	参数无效（缺少 image_url / video_url、朝向或模式错误等）
401	API Key 无效
402	余额不足
429	请求过于频繁

常见问题（FAQ）

为什么参考视频 29 秒，生成结果只有 3 秒，却收了 29 秒的费用？

Motion Control 处理上传的动作参考视频并按秒计费。模型可能只能成功提取部分连续有效动作，导致输出更短。此时已消耗的额度不会按照较短的输出时长重新计算。

若参考视频计费时长为 29 秒，有效单价为 $0.10288 / 参考视频秒，则 29 × $0.10288 = $2.98352。输出只有 3 秒，不会将本次费用改为 3 秒。

填 duration: 3 能让 29 秒参考视频只收 3 秒费用吗？

不能。duration 只是可选的预扣费估算值，不控制输出长度，也不是计费上限。服务端会探测参考视频时长并结合上游计费数据结算。

所有账号都是 $0.10288 吗？

不是。这里是供应商参考单价 $0.1286 应用 0.80 折扣后的 STD 示例单价。实际价格取决于在售渠道与账号分组，请核对实时模型卡和最终账单。