Kling V3 动作迁移 | PixMind Docs

将参考视频中的动作迁移到角色图片。

提供方

Kuaishou

模型 ID

kling-v3-motion-control

请求端点

POST /v1/generations

打开模型 Playground 创建 API Key

模型说明

PixMind 当前线路是 Motion Control，并非独立的 Kling 3.0 Turbo 文生视频线路。
计费使用最终视频时长，并向上取整到整秒。

请求参数

参数	类型	必填	说明
`model`	string	是	稳定的 PixMind 模型 ID，请使用 `kling-v3-motion-control`。可选值: `kling-v3-motion-control`
`prompt`	string	否	用于生成或编辑的自然语言指令。
`character_image_url`	string (URI)	是	需要保持外观的角色图片。
`motion_video_url`	string (URI)	是	提供身体动作和镜头运动的参考视频。
`resolution`	string	否	输出视频分辨率，该字段会影响每秒价格。可选值: `720p`, `1080p` 默认值: `720p`
`character_orientation`	string	否	角色朝向跟随源动作的方式。可选值: `image`, `video` 默认值: `image`
`keep_original_sound`	boolean	否	保留动作参考视频中的原始声音。可选值: `true`, `false` 默认值: `false`
`callback_url`	string (URI)	否	接收任务终态事件的 HTTPS 地址；不填写时仍可使用轮询。

请求示例

cURL

curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v3-motion-control",
  "prompt": "Preserve the character identity and reproduce the full-body movement",
  "character_image_url": "https://example.com/character.png",
  "motion_video_url": "https://example.com/motion.mp4",
  "resolution": "720p",
  "character_orientation": "image",
  "keep_original_sound": false
}'

JavaScript

const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "kling-v3-motion-control",
  "prompt": "Preserve the character identity and reproduce the full-body movement",
  "character_image_url": "https://example.com/character.png",
  "motion_video_url": "https://example.com/motion.mp4",
  "resolution": "720p",
  "character_orientation": "image",
  "keep_original_sound": false
})
});

const task = await response.json();

任务受理响应

生成任务为异步处理。请保存响应中的 id，并轮询 GET /v1/generations/{id}，直到任务进入终态。

202 Accepted

{
  "id": "img_01JXYZ...",
  "model": "kling-v3-motion-control",
  "status": "processing"
}

API 定价

配置	价格
720p 动作迁移	$0.160 / second
1080p 动作迁移	$0.240 / second

API 使用 apiPlatform 角色独立计费，与 PixMind Studio 积分分开；任务受理响应中的价格快照是最终计费依据。