用于参考引导式角色视频的 Kling V3 运动控制 API

通过 GoEnhance 访问 Kling V3 运动控制,使用 model: kling-v3-motion。提供外观和运动参考,提交一个异步请求,并通过轮询或回调跟踪返回的 img_uuid。
获取 API 密钥
为 Kling V3 运动控制 API 打造电影级运动参考制作

在单个请求中结合外观和运动参考

定义角色外观

使用 image_url 提供清晰的上半身或全身角色图像,或通过 element_ids 最多使用一个 Kling 元素。元素输入将强制使用 character_orientation: video。
用于角色视频生成的受控外观参考摄影

从参考视频中迁移运动

在 video_url 中提供必需的 MP4 或 MOV 文件。输出将遵循该文件中可用的连续运动;此端点没有 duration 参数。
用作运动参考的单场景编排排练
在提交前验证媒体;不支持的时长或分辨率值应在客户端拒绝。

Kling V3 运动控制 API 功能与验证规则

端点与模型

POST 请求至 https://api.goenhance.ai/api/v1/videos/generations,并使用 model: kling-v3-motion。

提示词

发送必需的 prompt(最多 2,500 个字符),以描述角色、服装、场景或相关的生成方向。

外观输入

image_url 可以是 JPG、JPEG 或 PNG 格式,最大 50 MB,每边至少 300 像素,宽高比在 1:2.5 到 2.5:1 之间。

运动输入

必需的 video_url 必须是 MP4 或 MOV 格式,不超过 100 MB,尺寸在 340 到 3,850 像素之间。

方向与时长

character_orientation: video 支持 3–30 秒;image 支持 3–10 秒。记录的默认值为 video。

分辨率与音频

选择 720p 或 1080p;暂无 4K 档位。generate_audio 将保留运动视频的原始声音,默认值为 false。
定价按生成秒数计算,而 GoEnhance 将输入动作视频的长度作为请求的收费上限。

Kling V3 运动控制 API 定价

720p 费率

每生成一秒消耗 6.3 个 token,按记录的每个 token $0.02计算,相当于每秒 $0.126。

1080p 费率

每生成一秒消耗 8.4 个 token,按记录的每个 token $0.02计算,相当于每秒 $0.168。

成本估算

将请求成本上限估算为测得的运动视频时长乘以所选分辨率的精确费率。

按量计费输入

GoEnhance 会在扣除积分前传输并测量 video_url,因此在测量后更改远程文件不会改变计费输入。

输出可能较短

Kling 会提取可用的连续动作,因此困难或极快的动作可能会导致输出长度短于参考视频。

无持续时间参数

请勿发送 duration;该端点会拒绝此参数,输出长度取决于从参考视频中提取的可用动作。

分六步集成 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。
获取 API 密钥
使用您有权处理的媒体,并为异步完成进行设计。

Kling V3 Motion Control 的开发者用例

角色表演片段

将经批准的动作参考应用于一致的角色外观,用于短篇叙事或宣传视频流水线。

舞蹈和编舞预览

将获得许可的排练动作转换为角色主导的预览,同时保留同意权和源音频权利。

游戏角色动画概念

在投入完整的动画工作流之前,根据角色艺术和录制的动作生成动作研究。

本地化营销活动变体

为区域性创意变体参数化提示词和外观输入,同时复用同一个任务编排层。

虚拟表演者工作流

围绕经批准的图像参考、动作资产和方向设置构建受控的表演者流水线。

预演

在进行下游编辑、合成和审查之前,测试动作参考是否适合某个角色。
关于集成、定价、验证以及快手 API 常见问题的解答。

Kling V3 运动控制 API 常见问题解答

Kling V3 运动控制 API 端点是什么?

通过 GoEnhance 使用 POST https://api.goenhance.ai/api/v1/videos/generations 并配合 model: kling-v3-motion 进行提交。响应将返回一个 img_uuid。

Kling V3 运动控制 API 定价是如何运作的?

720p 规格收费为 6.3 tokens/秒($0.126/秒),1080p 规格收费为 8.4 tokens/秒($0.168/秒)。GoEnhance 在扣费前会以请求的上限时长来衡量动态视频的持续时间。

我可以发送持续时间参数吗?

不可以。此端点会拒绝 duration 参数。参考视频必须满足特定方向的限制,且输出结果将遵循从中提取出的可用连续动作。

character_orientation 有什么作用?

video 模式遵循动态视频中的朝向,允许 3–30 秒的时长。image 模式遵循外观图像,允许 3–10 秒的时长。

API 可以生成原生音频吗?

不可以。generate_audio 仅保留动态视频的原始音轨。该参数默认为 false;请仅在拥有必要权利时使用音频功能。

我可以使用 Kling 元素代替图像吗?

V3 路由通过 element_ids(或单值别名 element_id)最多接受一个值。元素输入强制 character_orientation: video。

回调是如何工作的?

提供一个公共的 HTTPS custom_callback_url。回调主体与作业详情响应一致;非 200 状态码的投递可能会重试最多三次,超时时间为三秒。

这是快手的官方 API 吗?

不是。Kling 与快手相关联,但本页面描述的是通过 GoEnhance 进行的独立访问。GoEnhance 并非作为快手或 Kling 的官方 API、合作伙伴或模型开发者呈现。

使用 Kling V3 运动控制 API 进行构建