Kwaivgi Kling V1.6 T2V Standard API Documentation

Kwaivgi Kling V1.6 T2V Standard API Documentation

Playground

Try it on WaveSpeedAI!

Kling v1.6 boosts image-to-video quality by 195% over v1.5, with improved prompt understanding and richer physics-driven visual effects. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Kling V1.6 Text-to-Video Standard is Kuaishou’s reliable text-to-video generation model that creates high-quality videos from text descriptions. Generate smooth, cinematic videos with natural motion and excellent visual fidelity — perfect for content creators and marketers.


Why It Stands Out

  • High-quality generation: Produces detailed videos with natural motion and visual clarity.
  • Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
  • Negative prompt support: Exclude unwanted elements for cleaner outputs.
  • Flexible aspect ratios: Choose from 16:9, 9:16, or 1:1 to fit any platform.
  • Flexible duration: Generate 5 or 10 second videos.
  • Guidance control: Adjust how closely the output follows your prompt.

Parameters

ParameterRequiredDescription
promptYesText description of the video you want to generate.
aspect_ratioNoOutput aspect ratio: 16:9, 9:16, 1:1 (default: 16:9).
negative_promptNoElements to avoid in the output.
guidance_scaleNoPrompt adherence strength (default: 0.5).
durationNoVideo length: 5 or 10 seconds (default: 5).

Supported Aspect Ratios

Aspect RatioBest For
16:9YouTube, widescreen displays
9:16TikTok, Instagram Stories, Reels
1:1Instagram posts, social media squares

How to Use

  1. Write a prompt describing the scene, action, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
  2. Select aspect ratio — choose the format that fits your platform.
  3. Add a negative prompt (optional) — specify elements to exclude.
  4. Adjust guidance scale — higher values follow prompts more strictly.
  5. Set duration — choose 5 or 10 seconds.
  6. Click Run and wait for your video to generate.
  7. Preview and download the result.

Best Use Cases

  • Social Media Content — Create platform-optimized videos for TikTok, YouTube, Instagram.
  • Marketing & Advertising — Produce promotional videos and ad creatives.
  • Storytelling & Film — Generate cinematic scenes for short films and narratives.
  • Fantasy & Concept Art — Bring magical and fantastical scenes to life.
  • Music Videos — Create visual content for songs and audio tracks.

Pricing

DurationPrice
5 seconds$0.225
10 seconds$0.45

Pro Tips for Best Quality

  • Be detailed in your prompt — describe subject, action, environment, lighting, and mood.
  • Include style keywords like “magical realism,” “cinematic,” or “mystical tone.”
  • Use negative prompts to reduce artifacts like blur or distortion.
  • Choose the right aspect ratio: 16:9 for widescreen, 9:16 for mobile, 1:1 for social squares.
  • Lower guidance scale (0.3–0.5) for more natural results, higher for strict prompt adherence.

Notes

  • Processing time varies based on duration and current queue load.
  • Please ensure your prompts comply with content guidelines.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "16:9",
  "guidance_scale": 0.5,
  "duration": 5
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/kwaivgi/kling-v1.6-t2v-standard" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation. max length 2500
aspect_ratiostringNo16:916:9, 9:16, 1:1The aspect ratio of the generated media.
negative_promptstringNo-The negative prompt for the generation.
guidance_scalenumberNo0.50 ~ 1The 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.outputsarrayOutput values, usually URL strings; some models return text strings or structured result objects (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

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
data.modelstringModel ID used for the prediction
data.outputsarray<string | object>Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to poll for the prediction result
data.statusstringStatus: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2026 WaveSpeedAI. All rights reserved.