Kling Video API

Quick Start

Authentication

Add Authorization header with Bearer token to all requests:

Authorization: Bearer YOUR_API_KEY

Available Models

The multi-modal Omni models, Kling Video-O1 and Kling V3 Omni (text, image, video and subject input, plus video editing), are documented on the Kling Omni-Video API page.

Detailed Pricing

Kling V2.6 (Kling's official rates)

Kling V3

Kling Motion Control (30% off)

Endpoints

Request Parameters

Common Parameters

Advanced Parameters

Code Examples

curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "A girl dancing on the beach at sunset, cinematic lighting",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

Response Format

Create Task Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending",
    "model": "kling-video/kling-v2-6"
  }
}

Success Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "model": "kling-video/kling-v2-6",
    "resultUrls": ["https://...video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

Failed Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "failed",
    "model": "kling-video/kling-v2-6",
    "failMsg": "Content policy violation"
  }
}

Webhook Callback (callback_url)

Pass callback_url in the create request. When the task reaches the completed or failed terminal state, our server sends a single HTTP POST to that URL with Content-Type: application/json (no signing header). Delivery is retried up to 3 times (exponential backoff 1s/2s/4s, 10s per attempt); if still unsuccessful, a background job keeps retrying for up to 30 minutes until your endpoint returns 2xx.

Payload Structure

POST {your callback_url}
Content-Type: application/json

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "model": "kling-video/kling-v2-6",
    "state": "completed" | "failed",
    "param": "<JSON string>",            // request params, JSON.parse once
    "resultJson": "<JSON string> | null", // result object, JSON.parse once
    "failCode": null | "CONTENT_MODERATION | INVALID_INPUT | INSUFFICIENT_BALANCE | UPSTREAM_BUSY | UPSTREAM_FAILED | TIMEOUT | INTERNAL_ERROR | OTHER",
    "failMsg": null | "string",
    "retryable": true | false,           // present when state=failed: safe to retry/fallback
    "costTime": 12345,                    // duration in ms
    "completeTime": 1705123500000,        // ms epoch
    "createTime": 1705123450000           // ms epoch
  }
}

Note: data.param and data.resultJson are both JSON strings — call JSON.parse once on each.

Video task: shape after JSON.parse(data.resultJson)

{
  "resultUrls":    ["https://r2.apimodels.app/videos/xxx.mp4"],
  "videoDuration": 5,                  // optional, seconds
  "thumbnailUrl":  "https://...jpg",   // optional
  "videoSize":     "1280x720",         // optional
  "videoModel":    "kling-v2-6"        // optional
}

resultUrls is always present (length 1 in success, [] on failure). Other fields are optional and depend on the upstream — read defensively. When state=failed, resultJson is typically null or {"resultUrls":[]}.

Node.js receiver example

app.post('/webhook/kling-video', express.json(), (req, res) => {
  const { taskId, state, resultJson, failMsg } = req.body.data
  if (state === 'completed') {
    const r = JSON.parse(resultJson)
    console.log('video ready', taskId, r.resultUrls[0], r.videoDuration)
  } else {
    console.warn('video failed', taskId, failMsg)
  }
  res.status(200).end()                 // must be 2xx, otherwise we retry
})

Notes

• -A task stops retrying only after a 2xx response — once delivered it is never pushed again.
• -Callbacks are not signed today. Embed a random token in your callback_url path and verify it on receipt.
• -Kling video jobs typically take 30s to several minutes — strongly prefer callback_url over polling.
• -Use a public HTTPS endpoint that responds within 10 seconds (per-attempt timeout).

Task States

Error Codes

Important Notes

• *Video files are stored for 30 days, download promptly
• *If image parameter is provided, image-to-video mode is used automatically
• *V3 supports flexible 3-15s duration with per-second pricing
• *Audio generation is available for V2.6 (pro mode only) and V3 (set sound: "on")
• *Voice customization requires V2.6+ with sound: "on" and voice_list
• *Poll every 5-10 seconds to check status
• *Kling Motion Control requires both image (character reference) and motion_video (motion source) parameters