Kling Video API

This page specifies the Kuaishou Kling video model kling-3.0-turbo. It shares the POST /v1/videos create and GET /v1/videos/{id} polling flow with the other video models; authentication, media upload, polling states, downloads and error handling are covered in the Complete Video API Standard. This page lists only the fields and rules specific to Kling.

Updated 2026-10-10. Kling supports polling only: do not send callback_url, or the request is rejected.

Models

resolution selects the output tier and the tier that is billed, in either case (4k and 4K are equivalent). Without it, the lowest tier 720p is used. An unsupported tier returns 400; it is never downgraded.

Common rules

• Duration: whole seconds from 4 to 15 in duration (or the string seconds); defaults to 5.
• Aspect ratio: ratio (or aspect_ratio) accepts 16:9, 9:16 and 1:1.
• Prompt: prompt is required, up to 2000 characters.
• Generated audio: generate_audio (boolean) is supported.
• Reference audio: not supported; sending it returns 400.
• Optional fields: negative_prompt and seed (integer).

Reference images and videos

Put reference images in the top-level images and reference videos in metadata.referenceVideos. Up to 30 images (keyframes included) and 10 videos.

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "Keep the product from the images and the camera rhythm of the video; the product slowly rotates on a desk",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

First and last frames

Put keyframes in metadata.firstFrame and metadata.lastFrame. lastFrame requires firstFrame. Kling allows keyframes together with reference images, up to 30 images in total.

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "The camera glides from the coast at dawn to the same bay at dusk",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

File upload

You can also send one local image with multipart/form-data in the input_reference field; do not send images or image in the same request. Reference videos cannot be sent as files; obtain a URL through Local media upload first.

Earlier model names

The earlier names kling-3.0-turbo-720p, kling-3.0-turbo-1080p, kling-3.0-turbo-2k and kling-3.0-turbo-4k were retired on 2026-10-10, and requests using them now return an error. Use kling-3.0-turbo and select the tier with resolution.