Video models
Kling V2.1
On this page
Kling V2.1 — high-quality AI video generation.
| modelId | kling-v2-1-master-text-to-video, kling-v2-1-master-image-to-video, kling-v2-1-pro, kling-v2-1-standard |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| V2 1 Master Text To Video | kling-v2-1-master-text-to-video | POST /api/v1/generate | prompt |
| V2 1 Master Image To Video | kling-v2-1-master-image-to-video | POST /api/v1/generate | prompt, image_url |
| V2 1 Pro | kling-v2-1-pro | POST /api/v1/generate | prompt, image_url |
| V2 1 Standard | kling-v2-1-standard | POST /api/v1/generate | prompt, image_url |
| Poll task | — | GET /api/v1/task/{id}?model=kling-v2-1-master-text-to-video | — |
V2 1 Master Text To Video — kling-v2-1-master-text-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt describing the video you want to generate Max 5000 characters. (default: First-person view of a paraglider launching off an alpine ridge into golden-hour haze, wind buffeting the camera.) |
| duration | string | No | The duration of the generated video in seconds (options: 5 | 10) (default: 5) |
| aspect_ratio | string | No | The aspect ratio of the generated video frame (options: 16:9 | 9:16 | 1:1) (default: 16:9) |
| negative_prompt | string | No | Elements to avoid in the generated video Max 500 characters. (default: blur, distort, and low quality) |
| cfg_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (range 0-1) (default: 0.5) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"kling-v2-1-master-text-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","duration":"5","aspect_ratio":"16:9","negative_prompt":"blurry, low quality, distorted, watermark, text","cfg_scale":0.5,"nsfw_checker":true}}'V2 1 Master Image To Video — kling-v2-1-master-image-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt describing the video to generate Max 5000 characters. (default: Animate the still: the woodcarver's chisel taps in a steady rhythm as thin curls of wood peel away and settle on the bench, sawdust drifting through a shaft of window light, slow push-in.) |
| image_url | string | Yes | URL of the image to be used for the video (image URL) |
| duration | string | No | The duration of the generated video in seconds (options: 5 | 10) (default: 5) |
| negative_prompt | string | No | Negative prompt to exclude certain elements from the video Max 500 characters. (default: blur, distort, and low quality) |
| cfg_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (range 0-1) (default: 0.5) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"kling-v2-1-master-image-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","duration":"5","negative_prompt":"blurry, low quality, distorted, watermark, text","cfg_scale":0.5,"nsfw_checker":true}}'V2 1 Pro — kling-v2-1-pro
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text prompt describing the video to generate Max 5000 characters. (default: Animate the still: honey drizzles in a slow golden ribbon over a warm stack of pancakes, melting butter sliding down the sides as the camera eases in and faint steam drifts across the frame.) |
| image_url | string | Yes | URL of the image to be used for the video (image URL) |
| duration | string | No | The duration of the generated video in seconds (options: 5 | 10) (default: 5) |
| negative_prompt | string | No | Terms to avoid in the generated video Max 500 characters. (default: blur, distort, and low quality) |
| cfg_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (range 0-1) (default: 0.5) |
| tail_image_url | string | No | URL of the image to be used for the end of the video (image URL) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"kling-v2-1-pro","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","duration":"5","negative_prompt":"blurry, low quality, distorted, watermark, text","cfg_scale":0.5,"tail_image_url":"https://example.com/input.jpg","nsfw_checker":true}}'V2 1 Standard — kling-v2-1-standard
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text prompt describing the desired video content Max 5000 characters. (default: Animate the still: a gentle push-in as the painted moon slowly blinks, ribbons of stardust drift upward, and the floating islands sway with a dreamy parallax.) |
| image_url | string | Yes | URL of the image to be used for the video (image URL) |
| duration | string | No | The duration of the generated video in seconds (options: 5 | 10) (default: 5) |
| negative_prompt | string | No | Description of elements to avoid in the generated video Max 500 characters. (default: blur, distort, and low quality) |
| cfg_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (range 0-1) (default: 0.5) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"kling-v2-1-standard","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","duration":"5","negative_prompt":"blurry, low quality, distorted, watermark, text","cfg_scale":0.5,"nsfw_checker":true}}'