Skip to content
Docs menu

Video models

Kling V2.1

On this page

Kling V2.1 — high-quality AI video generation.

modelIdkling-v2-1-master-image-to-video, kling-v2-1-pro, kling-v2-1-standard
Modalityvideo
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
V2 1 Master Image To Videokling-v2-1-master-image-to-videoPOST /api/v1/generateprompt, image_url
V2 1 Prokling-v2-1-proPOST /api/v1/generateprompt, image_url
V2 1 Standardkling-v2-1-standardPOST /api/v1/generateprompt, image_url
Poll taskGET /api/v1/task/{id}?model=kling-v2-1-master-image-to-video

V2 1 Master Image To Video — kling-v2-1-master-image-to-video

FieldTypeRequiredValues / example
promptstringYesThe text prompt describing the video to generate Max 5000 characters. (example: 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… — full value in the request example)
image_urlstringYesURL of the image to be used for the video (image URL)
durationstringNoThe duration of the generated video in seconds (options: 5 | 10) (default: 5)
negative_promptstringNoNegative prompt to exclude certain elements from the video Max 500 characters. (default: blur, distort, and low quality)
cfg_scalenumberNoThe 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_checkerbooleanNoA 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":"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":"https://you.bot/examples/grok-imagine-text-to-image.jpg","duration":"5","negative_prompt":"blur, distort, and low quality","cfg_scale":0.5,"nsfw_checker":true}}'

V2 1 Pro — kling-v2-1-pro

FieldTypeRequiredValues / example
promptstringYesText prompt describing the video to generate Max 5000 characters. (example: 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… — full value in the request example)
image_urlstringYesURL of the image to be used for the video (image URL)
durationstringNoThe duration of the generated video in seconds (options: 5 | 10) (default: 5)
negative_promptstringNoTerms to avoid in the generated video Max 500 characters. (default: blur, distort, and low quality)
cfg_scalenumberNoThe 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_urlstringNoURL of the image to be used for the end of the video (image URL)
nsfw_checkerbooleanNoA 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":"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":"https://you.bot/examples/grok-imagine-text-to-image.jpg","duration":"5","negative_prompt":"blur, distort, and low quality","cfg_scale":0.5,"tail_image_url":"https://you.bot/examples/grok-imagine-text-to-image.jpg","nsfw_checker":true}}'

V2 1 Standard — kling-v2-1-standard

FieldTypeRequiredValues / example
promptstringYesText prompt describing the desired video content Max 5000 characters. (example: 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_urlstringYesURL of the image to be used for the video (image URL)
durationstringNoThe duration of the generated video in seconds (options: 5 | 10) (default: 5)
negative_promptstringNoDescription of elements to avoid in the generated video Max 500 characters. (default: blur, distort, and low quality)
cfg_scalenumberNoThe 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_checkerbooleanNoA 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":"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":"https://you.bot/examples/grok-imagine-text-to-image.jpg","duration":"5","negative_prompt":"blur, distort, and low quality","cfg_scale":0.5,"nsfw_checker":true}}'