Kirin Motion Control

认证

authorization `string` 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model `string` 必填

请求使用的模型 ID.

值：kirin_motion_control

image_url `string` 必填

参考图像, 生成视频中的人物、背景等元素均以参考图为准

图片内容要求：
人物比例尽量与参考动作比例一致, 尽量避免全身动作驱动半身人物进行生成
人物需要露出清晰的上半身或全身的肢体及头部, 避免遮挡
画面中人物避免存在极端朝向, 比如倒立、平卧等. 人物占画面比例不得太低
支持真实/风格化的角色（包括人物/类人动物/部分纯动物/部分类人肢体比例的角色）

支持传入图片 Base64 编码或图片 URL（确保可访问）

若您使用 Base64 的方式, 请确保您传递的所有图像数据参数均采用 Base64 编码格式. 在提交数据时, 请不要在 Base64 编码字符串前添加任何前缀, 例如 data:image/png;base64,. 正确的参数格式应该直接是 Base64 编码后的字符串

图片要求：
格式：.jpg, .jpeg, .png
文件大小：不超过 10MB
尺寸：介于 300px ~ 65536px
宽高比：介于 1:2.5 ~ 2.5:1 之间

video_url `string` 必填

参考视频的获取链接. 生成视频中的人物动作与参考视频一致

视频内容要求：
人物需要露出清晰的上半身或全身的全部肢体及头部, 避免遮挡
建议上传 1 人动作视频, 2 人及以上会取画面占比最大的人物动作进行生成
推荐使用真人动作, 部分风格化的人物/类人肢体比例可以通过
动作视频一镜到底, 角色始终出现在画面中, 避免切镜、运镜等, 否则会被截取
动作避免过快, 相对平稳的动作生成效果更佳

视频要求：
格式：.mp4, .mov
文件大小：不超过 100MB
尺寸：宽高均介于 340px ~ 3850px 之间

时长要求：
最短：3 秒
最长与 character_orientation 有关：
当人物朝向与视频中人物一致时：最长 30 秒
当人物朝向与图片中人物一致时：最长 10 秒

注意：如果您的动作难度比较高、速度比较快, 有一定概率生成不足上传视频时长的结果, 因为模型只能提取有效动作时长进行生成, 最短提取出 3 秒可用连续动作即可生成. 因此消耗的积分将无法退还, 建议适当调整动作难度与速度

character_orientation `string` 必填

生成视频中人物的朝向, 可选择与图片一致或与视频一致

image：与图片中人物朝向一致；此时参考视频时长不得超过 10 秒
video：与视频中人物朝向一致；此时参考视频时长不得超过 30 秒

选项：image, video

mode `string` 必填

生成视频的模式

std：标准模式（标准）, 基础模式, 性价比高
pro：专家模式（高品质）, 高表现模式, 生成视频质量更佳

选项：std, pro

prompt `string`

文本提示词, 可包含正向描述和负向描述

可通过提示词为画面增加元素、实现运镜效果等

不能超过 2500 个字符

keep_original_sound `string`

是否保留视频原声

yes：保留视频原声
no：不保留视频原声

选项：yes, no

默认值：yes

callback_url `string`

本次任务结果回调通知地址, 如果配置, 服务端会在任务状态发生变更时主动通知

external_task_id `string`

自定义任务 ID

用户自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询

单用户下需要保证唯一性

轮询

由于视频生成需要时间, 您需要在创建任务后轮询任务状态

初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取

响应格式

error `object`

错误信息.仅在状态为 failed 时出现.

code string

错误码

message string

详细错误信息

output `array`

生成结果.仅在状态为 completed 时出现.

content array

生成内容列表

type string

资源类型，如 video, image

url string

生成内容的 URL

duration number

视频时长

jobId string

远程任务 ID

usage `object`

使用统计.仅在状态为 completed 时出现.

cost string

总费用 (美元)

discount number

折扣金额

metadata `object`

元数据信息

错误码

错误码	描述
014002095	内部生成错误
014002096	结果解析异常
014002097	HTTP 错误响应
014002099	同步生成异常

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "model": "kirin_motion_control", "input": [ { "params": { "image_url": "https://example.com/input-image.jpg", "video_url": "https://example.com/reference-video.mp4", "character_orientation": "image", "mode": "std", "prompt": "A person dancing gracefully", "keep_original_sound": "yes" } } ] }'

{ "id": "d5u5obte8783ap44qtj0", "created_at": 1769757744021, "status": "completed", "model": "kirin_motion_control", "output": [ { "content": [ { "type": "video", "url": "https://example.com/generated-video.mp4", "duration": 5, "jobId": "remote_job_id_12345" } ] } ], "usage": { "cost": "0.000500", "discount": 0 }, "metadata": {} }

认证

authorization `string` 必填

参数

model `string` 必填

image_url `string` 必填

video_url `string` 必填

character_orientation `string` 必填

mode `string` 必填

prompt `string`

keep_original_sound `string`

callback_url `string`

external_task_id `string`

轮询

响应格式

error `object`

code `string`

message `string`

output `array`

content `array`

type `string`

url `string`

duration `number`

jobId `string`

usage `object`

cost `string`

discount `number`

metadata `object`

错误码

认证

authorization string 必填

参数

model string 必填

image_url string 必填

video_url string 必填

character_orientation string 必填

mode string 必填

prompt string

keep_original_sound string

callback_url string

external_task_id string

轮询

响应格式

error object

code string

message string

output array

content array

type string

url string

duration number

jobId string

usage object

cost string

discount number

metadata object

错误码

authorization `string` 必填

model `string` 必填

image_url `string` 必填

video_url `string` 必填

character_orientation `string` 必填

mode `string` 必填

prompt `string`

keep_original_sound `string`

callback_url `string`

external_task_id `string`

error `object`

code `string`

message `string`

output `array`

content `array`

type `string`

url `string`

duration `number`

jobId `string`

usage `object`

cost `string`

discount `number`

metadata `object`