Browse ModelsKwaivgiKwaivgi Kling V2.1 I2V Master

Kwaivgi Kling V2.1 I2V Master

Kwaivgi Kling V2.1 I2V Master

Playground

Try it on WavespeedAI!

Kling 2.1 Master is a premium image-to-video endpoint delivering fluid motion, cinematic visuals, and precise prompt-driven control. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.

Features

Kling v2.1 I2V Master — kwaivgi/kling-v2.1-i2v-master

Kling v2.1 I2V Master generates short, high-motion video clips from a single reference image plus a motion-focused prompt. Upload an image, describe what moves (subject, camera, environment), and the model animates the scene while keeping the source frame as the visual anchor. Built for stable production use with a ready-to-use REST API, no cold starts, and predictable pricing.

What it’s best at

  • Image-to-video generation with strong visual anchoring to the input image
  • Cinematic motion: camera moves, parallax, atmospheric effects, subtle facial/body motion
  • Prompt-controlled animation with optional negative_prompt to suppress artifacts
  • Fast iteration for 5-second clips (and longer durations if enabled)

Pricing

Equivalent unit price: $0.26 per second

Examples

DurationPrice
5s$1.30
10s$2.60
15s$3.90
20s$5.20

Inputs

  • image (required): the reference image used as the first-frame anchor
  • prompt (required): describe motion and camera behavior
  • negative_prompt (optional): describe what to avoid (blur, distortions, artifacts)

Parameters

  • prompt: the motion direction for the clip
  • negative_prompt: optional “avoid list” (quality issues, unwanted elements)
  • image: the input image (upload or URL)
  • guidance_scale: how strongly the motion follows the prompt (lower = more natural drift, higher = stricter prompt following)
  • duration: video length in seconds (commonly in 5-second steps)

Prompting guide (I2V)

Write prompts like a director’s brief, prioritizing motion over static description:

  • Subject motion: head turn, breathing, hair flutter, hand movement, walking, reading, etc.
  • Environment motion: wind in trees, dust, rain, fog, floating particles, light beams
  • Camera motion: slow push-in, orbit, handheld micro-shake, tilt up, dolly left, rack focus
  • Continuity constraints: keep identity, outfit, and scene layout consistent with the input image

Good pattern: A short description of the scene, then explicit motion cues, then camera movement, then mood/lighting continuity.

Example prompts

  • A mysterious woman reading a spellbook in a dark forest. Camera slowly circles her, faint magical lights float around, glowing runes appear, trees subtly twist in the background, cinematic mist and particles, moody low-key lighting, smooth motion, 5 seconds.
  • A street portrait at golden hour. Subtle breeze moves hair and clothes, soft lens flare, gentle handheld camera sway, shallow depth of field, natural facial micro-expressions, 5 seconds.
  • A product shot on a table. Camera slow push-in, specular highlights glide across the surface, light dust motes in the air, clean studio feel, crisp focus, 5 seconds.

Negative prompt examples

  • blur, distort, low quality
  • jitter, warping, melted details, extra limbs, duplicate face
  • watermark, logo, subtitles, text artifacts, compression blocks

Best practices

  • Use a sharp, well-lit reference image; the model can’t “invent” clean details that aren’t there.
  • Keep motion instructions compatible with the image (don’t ask for a full outfit change if you only want animation).
  • If results look unstable or over-animated, lower guidance_scale and simplify motion.
  • If motion is too subtle, add clearer action verbs (turns, steps, lifts, sways) and specify a camera move.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/kwaivgi/kling-v2.1-i2v-master" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "guidance_scale": 0.5,
    "duration": 5
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.max length 2500
negative_promptstringNo-The negative prompt for the generation.
imagestringYes-First frame of the video; Supported image formats include.jpg/.jpeg/.png; The image file size cannot exceed 10MB, and the image resolution should not be less than 300*300px.
guidance_scalenumberNo0.50.00 ~ 1.00The guidance scale to use for the generation.
durationintegerNo55, 10The duration of the generated media in seconds.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.