Kling 3.0 Motion Control
使用此模型提交视频生成任务,再通过返回的任务 ID 查询结果。
模型 ID official-kling-v3-motion-control
快速开始
创建 并设置 I2V_API_KEY。每个新任务设置一个 IDEMPOTENCY_KEY,重试同一次提交时复用原幂等键和请求体。
提交任务
POST https://api.i2v.ai/api/v1/jobs/createTask
bash
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "official-kling-v3-motion-control",
"inputs": {
"prompt": "A calm lake at sunrise",
"resolution": "720p",
"duration": 5
}
}'HTTP 200 表示任务已受理。保存返回的 taskId。
json
{"taskId":"YOUR_TASK_ID"}查询结果
bash
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"将 YOUR_TASK_ID 替换为返回的任务 ID。状态为 waiting 或 generating 时退避轮询。success 时读取 output[].url,fail 时检查 error。
请求参数
模型输入放在 inputs 对象中。素材 URL 需要可公开访问。必需素材及参数组合取决于具体生成模式。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
inputs.prompt | string | 否 | — | 可选的表演或画面引导。 上限 2500 字符. |
inputs.resolution | string | 否 | 720p | 输出分辨率。 可选值 720p, 1080p. |
inputs.duration | number | 否 | 5 | 视频时长,单位为秒。 可选值 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. |
inputs.urls | string[] | 否 | — | 关键帧图片地址,前两项分别为首帧和尾帧。 上限 2 个 URL. |
inputs.referenceImageUrls | string[] | 否 | — | 恰好一张角色图,脸部、肩部与躯干需清晰可见。 上限 1 个 URL. |

