跳至正文
EN
获取 API Key
☰
Kling · 模型接口

Kling 3.0 Motion Control API 价格与接入

Kling 3.0 Motion Control API 的模型能力、计价规格、请求参数和接入示例。使用 VezAPI 账号密钥统一接入。

视频编辑

Kling 3.0 Motion Control API 接入文档

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

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

Kling-3.0 motion-control

POST/api/v1/jobs/createTask

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

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。必填字段。 - 此端点必须为 `kling-3.0/motion-control`

可选值："kling-3.0/motion-control"

默认："kling-3.0/motion-control"

callBackUrl
必填		string

接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

input
必填		object
input.prompt
可选		string

(可选) 文本提示词，用于引导生成动画内容，可为空或 0-2500 字符

input.input_urls
必填		array

(必填)包含一个图片url

maxItems: 1

input.video_urls
必填		array

(必填)包含一个视频url

maxItems: 1

input.mode
可选		string

可选。输出分辨率："720p"（默认）或 "1080p"。

可选值："720p", "1080p"

默认："720p"

input.character_orientation
可选		string

(可选) 角色朝向参考来源。video: 参考视频 (推荐)；image: 参考图片。默认值: video

请求示例
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-3.0/motion-control",
  "callBackUrl": "Your prompt",
  "input": {
    "prompt": "Your prompt",
    "input_urls": [
      "Your prompt"
    ],
    "video_urls": [
      "Your prompt"
    ]
  }
}'
返回值与错误

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.

HTTP 500

响应字段与业务状态码。

参数类型说明与限制
code
必填		integer

业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。

msg
必填		string

响应消息；失败时说明错误原因。

data
必填		object

任务状态与回调

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

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

文件、日志与计费

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

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

打开完整文档 →

Kling 3.0 Motion Control API 价格

下方费率为参考估算，最终按实际优惠扣分 1:1 结算。按标准充值包换算，1,000 积分约为 10 美元，大额充值包可降低每积分实际单价。

规格积分计价单位美元参考
kling 3.0 motion control, video-to-video, 1080P30.2每秒$0.302
kling 3.0 motion control, video-to-video, 720P22.7每秒$0.227