
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-omni 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-omni",
"inputs": {
"prompt": "A calm lake at sunrise",
"duration": 5,
"resolution": "720p",
"aspectRatio": "16:9"
}
}')
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-omniKling 3.0 Omni (O3) is Kuaishou's multimodal tier: text, first and last frames, up to seven reference images, a reference video, or transformation of existing footage, with optional native audio and output up to 4K.
/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.
11 fields
| Parameter | Required | Type | Allowed | Default | Description |
|---|---|---|---|---|---|
| prompt | No | string | ≤ 3072 chars | Not recorded | Shot description, transformation goal, or guidance for the reference media. |
| imageUrl | No | string | Not recorded | Not recorded | Keyframe image URLs. The first two entries are the first and last frames. |
| uploadedUrls | No | string[] | ≤ 4 | Not recorded | Up to 7 reference images for identity and style, or up to 4 alongside a video. |
| imageUrls | No | string[] | ≤ 4 | Not recorded | Additional public image URLs, merged with uploadedUrls and de-duplicated in request order. |
| videoUrls | No | string[] | ≤ 1 | Not recorded | One reference video guiding motion and look; audio is forced off in this mode. |
| duration | No | number | 3–15 s | 5 s | Video duration in seconds. |
| ratio | No | enum | 16:9, 9:16, 1:1 | 16:9 | Output aspect ratio. |
| outputResolution | No | enum | 720p, 1080p, 4k | 720p | Output resolution. |
| generate_audio | No | boolean | true, false | Not recorded | Whether to generate audio with the video. |
| 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-omni",
"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>