动作控制
OpenAPI Specification
yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/kling/v1/videos/motion-control:
post:
summary: 动作控制
deprecated: false
description: ''
tags:
- 可灵 Kling 平台/动作控制
parameters:
- name: Content-Type
in: header
description: ''
required: false
example: application/json
schema:
type: string
- name: Authorization
in: header
description: ''
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
prompt:
type: string
description: |-
文本提示词，可包含正向描述和负向描述
可通过提示词为画面增加元素、实现运镜效果等，详见可灵「动作控制」使用指南
不能超过2500个字符
image_url:
type: string
description: |-
参考图像，生成视频中的人物、背景等元素均已参考图为准
视频内容需满足以下要求：
人物可以是写实风格人物或与自然人身材比例相似的卡通风格人物，避免遮挡；写实风格人物效果更好
图像中人物面积需超过图像面积的5%
包含支持传入图片Base64编码或图片URL（确保可访问）
图片格式支持.jpg / .jpeg / .png
图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
keep_original_sound:
type: string
description: |-
可选择是否保留视频原声
枚举值：yes，no
其中yes：保留视频原声
其中no：不保留视频原声
character_orientation:
type: string
description: |-
生成视频中人物的朝向，可选择与图片一致或与视频一致
枚举值：image，video，其中：
其中image：与图片中人物朝向一致；此时参考视频时长不得超过10秒；
其中video：与视频中人物朝向一致；此时参考视频时长不得超过30秒；
mode:
type: string
description: |-
生成视频的模式
枚举值：std，pro
其中std：标准模式（标准），基础模式，性价比高
其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
callback_url:
type: string
external_task_id:
type: string
video_url:
type: string
description: >-
视频内容需满足以下要求：
有且只能有1个写实风格、全身或上半身、包含头部的人物，避免遮挡
人物肢体动作与表情动作清晰且不包括空翻、倒立等复杂动作
动作视频一镜到底，人物始终出现在画面某种，避免切镜、运镜等
视频文件支持.mp4/.mov，文件大小不超过100MB，仅支持长宽的边长均位于340px~3850px之间，上述校验不通过会返回错误码等信息
视频时长下限不短于3秒，时长上限与人物朝向参考（character_orientation）有关：
当人物朝向与视频中人物一致时，视频时长最长可达30秒；
当人物朝向与图片中人物一致时，视频时长最长可达10秒；
系统会校验视频内容，如有问题会返回错误码等信息
required:
- image_url
- video_url
- character_orientation
- mode
x-apifox-orders:
- prompt
- image_url
- video_url
- keep_original_sound
- character_orientation
- mode
- callback_url
- external_task_id
example:
prompt: 让图片的人像视频一样
image_url: >-
https://p4-fdl.klingai.com/ksc2/nNAclQB2ZuqDEm6MuN_yy7WBwX-VSJ7DW9BzEq8AkSf2xBrbVVc9NS3viTiOht2ZEAtnU4f1PzqCQXnbt9smNKHN5hFuxmFfnLJvxQSoaKr3d8vZFp_JXOZcvL8f0W4-5FUtQlu-PFIvxwsn8X2IROKghKCLqQ0PYX3TTXwhwKJo7NSqCKuxwJ7sgTA11Mflkq87--ArN1PdxLGee5rD8Q.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG-oRROZ9QX15Z136vy0U9XHk81HfVTfutTifK00RSAJkOox6WfOhljFJYGmpGu7T-pSjkrc_jglivtThAq9w3maStP4AVnvsU6EPV4k11h96vHnPr6ncT_07t-LV7oB0Pnqe0NAWTihVWvffzo1zwRKu-pBBVHD5fFUeofm38uHCJ2AWCiZXlovy-uswtyMu_peSMPM9ZW86ua5VeOkcCgxUGIXM-wJoP1Ratuf4elGBoSbgFFnrpiqTZzapT733K7iU3CIiDpcbQXOnQEs1YkUZvWhgfnDOlog1MrqRmXk3KyN-YA7igFMAE&x-kcdn-pid=112757&pkey=AAX4LOOHvIOIhksHRujlp02vvKT9cVyrKSKpi4zbGommETuT4G-aRzmXzf_canc9UMFYghw1t8FCfEc4TuhzxFOpVxb9-fxtocDBi87kZ6AZx6UXcHr99mq-Eql-V6szHYE
video_url: >-
https://v2-fdl.kechuangai.com/bs2/upload-ylab-stunt/ai_portal/1765888564/iruVi3xLEK/%E6%AF%94%E5%BF%83%E8%88%9E.mp4?x-kcdn-pid=112344&pkey=AAV4qWDBpdlkaoPLTTibRcE45eU-vvFFLSfJ39G1-dNBsyDL-EjgGQkJH5kfTPSBRlhyHURv15jluiHTfSDctyD-maauTUuZdcoxgiEUpRNKfwq4td2_MKfg2i-K4bR9djo&cacheKey=CiJzaW5nbGUuc2VjdXJpdHkua2xpbmcubWV0YV9lbmNyeXB0ElCo5bcLqm5hc4LTbnmm1AmjOr6OYQsjXuU6/RsYhpAClCPVu6SzBDoPn9P4Z9MsRhOJRm1o1gofTQyuZ8he5zIdjqH57E33Bfr52J2f++pe7BoSM3fb7wMl2Fj3O+srsempz23IIiDAFsw1NAobuaeyIDF2sRlg9gt4F/VLTu5CeSYyIHkxdSgFMAE=
keep_original_sound: 'yes'
character_orientation: image
mode: std
callback_url: ''
external_task_id: ''
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties: {}
headers: {}
x-apifox-name: 成功
security:
- bearer: []
x-apifox-folder: 可灵 Kling 平台/动作控制
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/5443236/apis/api-398754751-run
components:
schemas: {}
securitySchemes:
bearer:
type: http
scheme: bearer
servers:
- url: https://www.anyapi.vip
description: 正式环境
security:
- bearer: []