
Kling 3.0 Turbo is the fast tier of Kuaishou's Kling 3 line. It turns a prompt, or a single first-frame image, into a 3–15 second clip at 720p or 1080p, with the same motion quality as its siblings at a lower price.
Kling v3 Turbo
Kling動画
公開日2026年6月
Kling AI
PublishedVideoUse model official-kling-v3-motion-control with a single create call, then poll the result endpoint. All requests use the same API key and USD balance.
Runs end-to-end: submit a task, then poll until it completes.
#!/usr/bin/env bash
set -euo pipefail
I2V_API_KEY="${I2V_API_KEY:?Set your API key: export I2V_API_KEY=...}"
# 1. Submit task
RESPONSE=$(curl -s -X POST "https://i2v.ai/api/v1/jobs/createTask" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $I2V_API_KEY" \
-d '{
"model": "official-kling-v3-motion-control",
"inputs": {
"prompt": "A calm lake at sunrise",
"resolution": "720p",
"duration": 5
}
}')
TASK_ID=$(echo "$RESPONSE" | grep -o '"taskId":"[^"]*"' | cut -d'"' -f4)
echo "Task created: $TASK_ID"
# 2. Poll until complete
while true; do
RESULT=$(curl -s "https://i2v.ai/api/v1/jobs/recordInfo?taskId=...?taskId=$TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY")
STATUS=$(echo "$RESULT" | grep -o '"status":"[^"]*"' | head -1 | cut -d'"' -f4)
case "$STATUS" in
success) echo "$RESULT"; break ;;
fail) echo "Failed: $RESULT"; exit 1 ;;
*) echo "Status: $STATUS — waiting..."; sleep 2 ;;
esac
doneofficial-kling-v3-motion-controlKling 3.0 Motion Control transfers the movement of a reference performance onto a character image. It keeps the performer's timing and body language while you choose where the character looks and which background it keeps.
/api/v1/jobs/createTaskCreate a generation task and return its task ID.
/api/v1/jobs/recordInfo?taskId=...Read one task by taskId; poll it until the status is success or fail.
/api/v1/accountReturn the current USD balance of the API key owner.
8 fields
| Parameter | Required | Type | Allowed | Default | Description |
|---|---|---|---|---|---|
| prompt | No | string | ≤ 2500 chars | Not recorded | Optional direction for the performance or the look of the shot. |
| imageUrl | No | string | Not recorded | Not recorded | Single public image URL. Used as the first frame by default, or as a reference image when the request declares reference mode. |
| uploadedUrls | No | string[] | ≤ 1 | Not recorded | Exactly one character image with the face, shoulders and torso clearly visible. |
| imageUrls | No | string[] | ≤ 1 | Not recorded | Additional public image URLs, merged with uploadedUrls and de-duplicated in request order. |
| duration | No | number | 3–15 s | Not recorded | Output duration in seconds. Must be one of the values allowed by the model. |
| outputResolution | No | enum | 720p, 1080p | 720p | Output resolution. |
| callBackUrl | No | string | Not recorded | Not recorded | HTTPS callback URL for signed completion delivery. Top-level request field, not part of inputs. |
| expectedRevision | No | number | Not recorded | Not recorded | Revision of the model settings the client expects. A mismatch returns HTTP 409 conflict. Top-level request field. |
{
"taskId": "..."
}{
"taskId": "...",
"model": "official-kling-v3-motion-control",
"status": "success",
"creditsUsed": 100,
"output": [
{
"url": "...",
"width": 1280,
"height": 720
}
],
"error": null,
"createTime": 1760000000000,
"completeTime": 1760000060000
}{
"code": "invalid_params",
"message": "Invalid request parameters"
}| Status values | Description |
|---|---|
| waiting | Task queued |
| generating | Processing in progress |
| success | Output ready |
| fail | Generation failed |
| Code | HTTP | Description |
|---|---|---|
| invalid_params | 400 | Request body, inputs or model ID is invalid. |
| unauthorized | 401 | API key is missing, invalid or expired. |
| insufficient_credits | 402 | Available USD balance is below the quoted amount. The response may include required and available. |
| access_denied | 403 | The task belongs to another account, or the account or entitlement is unavailable. |
| not_found | 404 | Task not found. |
| conflict | 409 | expectedRevision does not match, or the idempotency key was reused with a different payload. |
| concurrency_limit | 429 | The account reached its concurrent task limit. |
| rate_limit | 429 | The account reached its per-minute submission limit. |
| internal_error | 500 | Unexpected server error. |
| service_unavailable | 503 | Authentication or an upstream dependency is temporarily unavailable. |
Send your API key as a Bearer token in the Authorization header. Create and revoke keys in Settings → API keys.
Send Authorization: Bearer API_KEY and Content-Type: application/json. Reuse one Idempotency-Key for the same logical create; the same key with a different payload is rejected.
Authorization: Bearer $I2V_API_KEYContent-Type: application/jsonIdempotency-Key: <uuid>