POST
动作控制(可灵 3.0)

授权

Authorization
string
header
必填

LoopRouter API Key(sk- 开头),在控制台「令牌」页创建

路径参数

model
enum<string>
必填

占位模型名,计费固定 kling-3.0-motion-control

可用选项:
kling-3.0,
kling-3.0-motion-control

请求体

application/json

动作控制请求,支持两种形态。官方形态:contents[] + settings。扁平兼容形态:顶层 image_url / video_url / mode / character_orientation / keep_original_sound / element_list。 两者并存时以 contents / settings 优先。

contents
object[]

官方形态素材数组(image / video / prompt / element)

settings
object
prompt
string

动作 / 场景描述(扁平形态)

image_url
string

被驱动的图片 / 主体图地址(扁平形态)

video_url
string

驱动动作的参考视频地址(扁平形态)

element_list
object[]

可选,引用已创建的自定义主体(扁平形态)

keep_original_sound
enum<string>

是否保留参考视频原声(扁平形态)

可用选项:
yes,
no
character_orientation
enum<string>

主体朝向基准(扁平形态)

可用选项:
image,
video
mode
enum<string>

生成模式,映射分辨率档位(std→720p,pro→1080p)(扁平形态)

可用选项:
std,
pro
watermark_info
object

响应

任务创建成功

code
integer
示例:

0

message
string
示例:

"SUCCEED"

request_id
string
data
object