Kling 3.0 Motion Control
Create a video task with this model, then query its result using the returned task ID.
Model ID official-kling-v3-motion-control
Quickstart
Create an and set I2V_API_KEY. Set IDEMPOTENCY_KEY once for each new task. Reuse the key and identical payload when retrying that submission.
Submit a task
POST https://api.i2v.ai/api/v1/jobs/createTask
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 means the task was accepted. Save the returned taskId.
{"taskId":"YOUR_TASK_ID"}Query the result
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"Replace YOUR_TASK_ID with the returned ID. Poll with backoff while the status is waiting or generating. Read output[].url on success, or inspect error on fail.
Parameters
Send model inputs inside inputs. Media URLs must be publicly accessible. Required media and supported combinations depend on the selected generation mode.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
inputs.prompt | string | No | — | Optional direction for the performance or the look of the shot. Maximum 2500 characters. |
inputs.resolution | string | No | 720p | Output resolution. Allowed 720p, 1080p. |
inputs.duration | number | No | 5 | Video duration in seconds. Allowed 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, , . |

