model: kling-v3-motion。提供外观和运动参考，提交一个异步请求，并通过轮询或回调跟踪返回的 img_uuid。用于参考引导式角色视频的 Kling V3 运动控制 API
通过 GoEnhance 访问 Kling V3 运动控制，使用
获取 API 密钥
在单个请求中结合外观和运动参考
在提交前验证媒体；不支持的时长或分辨率值应在客户端拒绝。
Kling V3 运动控制 API 功能与验证规则
端点与模型
POST 请求至 <code>https://api.goenhance.ai/api/v1/videos/generations</code>，并使用 <code>model: kling-v3-motion</code>。
提示词
发送必需的 <code>prompt</code>（最多 2,500 个字符），以描述角色、服装、场景或相关的生成方向。
外观输入
<code>image_url</code> 可以是 JPG、JPEG 或 PNG 格式，最大 50 MB，每边至少 300 像素，宽高比在 1:2.5 到 2.5:1 之间。
运动输入
必需的 <code>video_url</code> 必须是 MP4 或 MOV 格式，不超过 100 MB，尺寸在 340 到 3,850 像素之间。
方向与时长
<code>character_orientation: video</code> 支持 3–30 秒；<code>image</code> 支持 3–10 秒。记录的默认值为 <code>video</code>。
分辨率与音频
选择 720p 或 1080p；暂无 4K 档位。<code>generate_audio</code> 将保留运动视频的原始声音，默认值为 false。
定价按生成秒数计算，而 GoEnhance 将输入动作视频的长度作为请求的收费上限。
Kling V3 运动控制 API 定价
720p 费率
每生成一秒消耗 6.3 个 token，按记录的每个 token $0.02计算，相当于每秒 $0.126。
1080p 费率
每生成一秒消耗 8.4 个 token，按记录的每个 token $0.02计算，相当于每秒 $0.168。
成本估算
将请求成本上限估算为测得的运动视频时长乘以所选分辨率的精确费率。
按量计费输入
GoEnhance 会在扣除积分前传输并测量 <code>video_url</code>，因此在测量后更改远程文件不会改变计费输入。
输出可能较短
Kling 会提取可用的连续动作，因此困难或极快的动作可能会导致输出长度短于参考视频。
无持续时间参数
请勿发送 <code>duration</code>；该端点会拒绝此参数，输出长度取决于从参考视频中提取的可用动作。
分六步集成 Kling V3 Motion Control
1
1. 创建 API 密钥
创建 GoEnhance API 密钥并将其放入
Authorization 请求头中发送。 2
2. 验证两个参考项
检查图像的清晰度和尺寸，然后验证动作视频的格式、大小、尺寸以及取决于方向的长度。
3
3. 提交并持久化任务
使用
model: kling-v3-motion 发送 POST 请求，并在将工作交给后台处理器之前保存返回的 img_uuid。 4
4. 跟踪状态
轮询
GET /api/v1/jobs/detail 或提供一个可公开访问的 HTTPS custom_callback_url。 5
5. 幂等地处理回调
安全地处理重复的状态事件。对于未返回 HTTP 200 的回调，最多可重试三次，每次尝试的超时时间为三秒。
6
6. 存储最终结果
将处理、成功和失败处理分开，仅在任务达到最终状态后保存最终视频 URL。
使用您有权处理的媒体，并为异步完成进行设计。
Kling V3 Motion Control 的开发者用例
角色表演片段
将经批准的动作参考应用于一致的角色外观，用于短篇叙事或宣传视频流水线。
舞蹈和编舞预览
将获得许可的排练动作转换为角色主导的预览，同时保留同意权和源音频权利。
游戏角色动画概念
在投入完整的动画工作流之前，根据角色艺术和录制的动作生成动作研究。
本地化营销活动变体
为区域性创意变体参数化提示词和外观输入，同时复用同一个任务编排层。
虚拟表演者工作流
围绕经批准的图像参考、动作资产和方向设置构建受控的表演者流水线。
预演
在进行下游编辑、合成和审查之前，测试动作参考是否适合某个角色。
关于集成、定价、验证以及快手 API 常见问题的解答。