Kling 2.6 Motion Control API 接入文档

使用 VezAPI 密钥接入 Kling 2.6 Motion Control。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Kling-2.6 motion-control

POST/api/v1/jobs/createTask

模型标识： kling-2.6/motion-control

参数	类型	说明与限制
`model` 必填	`string`	用于生成任务的模型名称。必填字段。 - 此端点必须为 `kling-2.6/motion-control` 可选值：`"kling-2.6/motion-control"` 默认：`"kling-2.6/motion-control"`
`callBackUrl` 可选	`string`	接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 系统将在生成完成时向此 URL 发送 POST 请求 - 回调包含生成的内容 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点来轮询任务状态
`input` 可选	`object`	生成任务的输入参数
`input.prompt` 可选	`string`	所需输出的文本描述。最大长度为 2500 个字符。（最大长度：2500 个字符） `maxLength: 2500`
`input.input_urls` 必填	`array`	包含单个图像 URL 的数组。照片必须清楚显示对象的头部、肩膀和躯干。（上传后的文件 URL，不是文件内容；接受的类型：image/jpeg, image/png, image/jpg；最大大小：10.0MB,尺寸需要大于 300px, 宽高比 1:2.5 to 2.5:1.） `maxItems: 1`
`input.video_urls` 必填	`array`	包含单个视频 URL 的数组。持续时间必须在 3 到 30 秒之间，视频必须清楚显示对象的头部、肩膀和躯干。（上传后的文件 URL，不是文件内容；接受的类型：video/mp4, video/quicktime；最大大小：100.0MB） `maxItems: 1`
`input.character_orientation` 必填	`string`	必填。生成视频中角色的方向。'image': 与图片中的人相同（最大 10 秒视频）。'video': 与视频中的人相同（最大 30 秒视频）。可选值：`"image", "video"`
`input.mode` 必填	`string`	必填。输出分辨率模式。使用 '720p' 表示 720p 或 '1080p' 表示 1080p。可选值：`"720p", "1080p"`

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "kling-2.6/motion-control",
  "input": {
    "prompt": "The cartoon character is dancing.",
    "input_urls": [
      "https://example.com/input.png"
    ],
    "video_urls": [
      "https://example.com/input.png"
    ],
    "character_orientation": "video",
    "mode": "720p"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。