Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runblob.io/llms.txt

Use this file to discover all available pages before exploring further.

Base URL: https://platform.runblob.io

​
POST /v1/kling/generate

Submits an asynchronous Kling generation job. Supports text-to-video, image-to-video, and Motion Control across Kling 1.6 through 3.0.
​
prompt
string
required
Text description of the video (1-2500 characters)
​
negative_prompt
string
What should NOT be in the video (max 2500 characters)
​
model
string
default:"kling_2.5_turbo"
Model to use.Available models:
  • kling_3 (NEW: Kling 3.0 Standard — 720p, duration 3-15s as int)
  • kling_3_pro (NEW: Kling 3.0 Pro — 1080p, duration 3-15s as int)
  • kling_3_motion (NEW: Kling 3.0 Motion Control Standard — recommended)
  • kling_3_motion_pro (NEW: Kling 3.0 Motion Control Pro)
  • kling_2.6_motion (Motion Control Standard, legacy)
  • kling_2.6_motion_pro (Motion Control Pro, legacy)
  • kling_2.6 (Audio-enabled, always Pro quality)
  • kling_2.5_turbo (Standard/Turbo)
  • kling_2.5_turbo_pro (Professional/Turbo Pro)
  • kling_2.1 (Standard)
  • kling_2.1_pro (Professional)
  • kling_2.1_master (Master, no pro mode)
  • kling_1.6 (Standard)
  • kling_1.6_pro (Professional)
​
duration
string | int
default:"5"
Duration of the video.
  • For kling_3 / kling_3_pro: integer from 3 to 15 (e.g. 4, 10). Per-second pricing applies.
  • For all other models: string "5" or "10".
​
aspect_ratio
string
default:"16:9"
Video aspect ratio: "16:9", "9:16", "1:1"
For image-to-video mode, aspect ratio is automatically determined from the input image and should not be specified.
​
cfg_scale
number
default:"0.5"
Creativity balance (0.0-1.0). 0.0 = maximum creativity, 1.0 = strict prompt following
​
seed
number
Reproducibility seed (0-2147483647)
​
callback_url
string
Webhook URL for completion notifications
​
image_base64
string
Base64-encoded image for Image-to-Video (JPEG/PNG/WEBP)
​
image_url
string
URL of image for Image-to-Video
​
reference_video_base64
string
Base64-encoded reference video for Motion Control (MP4/MOV/WEBP)Requirements:
  • Duration: 3-30 seconds
​
reference_video_url
string
URL of reference video for Motion Control
​
reference_image_base64
string
Base64-encoded reference image for Motion Control (JPEG/PNG/WEBP)
​
reference_image_url
string
URL of reference image for Motion Control
Motion Control requirements:
  • Both reference_video AND reference_image are required
  • Video duration must be between 3 and 30 seconds
  • Cannot use both _base64 and _url for the same media type
curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling_3",
    "prompt": "A golden retriever running through a sunflower field at sunset",
    "duration": 4
  }'

​
Response

Standard/Pro Models: 
{
  "generation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "price": "0.0250"
}
Motion Control: 
{
  "generation_id": "80844def-c17a-4381-9c07-036cb8c5f045",
  "status": "pending",
  "price": "0.3936"
}
Video generation typically takes 2-5 minutes. Motion Control generation takes 3-6 minutes. Use the generation_id to check status or set up webhooks for notifications.

​
Get Generation Status Response

{
    "generation_id": "5b92cd9c-2ddf-45a4-9bd1-7b13afaf1186",
    "status": "completed",
    "prompt": "cat and dog play together",
    "video_url": "https://storage.runblob.io/...",
    "model": "kling_2.5_turbo"
}

​
Generation Modes

The API supports 3 generation modes:

​
1. Text-to-Video

Generate video from text prompt only (no images). Models: kling_1.6, kling_2.1_master, kling_2.5_turbo, kling_2.6, kling_3, kling_3_pro
kling_2.1 and kling_2.1_pro do NOT support text-to-video. They require an input image.

​
2. Image-to-Video

Animate a single image with text prompt using image_base64 or image_url parameter.
  • Formats: JPEG, PNG, WEBP
  • Max size: ~10 MB
  • Models: kling_1.6, kling_2.1, kling_2.1_master, kling_2.5_turbo, kling_2.6, kling_3, kling_3_pro (and their _pro variants where applicable)
Important: You cannot use both image_base64 and image_url in the same request. For image-to-video mode, aspect ratio is taken from the input image automatically.

​
3. Motion Control

Transfer motion and style from a reference video to a reference image.
  • Required: Both reference_video AND reference_image
  • Video duration: 3-30 seconds
  • Video formats: MP4, MOV, WEBM
  • Image formats: JPEG, PNG, WEBP
  • Models: kling_3_motion, kling_3_motion_pro, kling_2.6_motion, kling_2.6_motion_pro
  • Pricing: Per second (rounded up)
    • Standard: $0.041/sec
    • Pro: $0.082/sec (2x price)
  • Aspect ratio & duration: Auto-detected from reference video
{
  "prompt": "Apply this motion to the scene",
  "model": "kling_2.6_motion",
  "reference_video_url": "https://example.com/motion.mp4",
  "reference_image_url": "https://example.com/scene.jpg"
}

​
Models Guide

​
Kling 3.0 (NEW)

  • Codes: kling_3, kling_3_pro
  • Features:
    • Text-to-video: Yes
    • Image-to-video: Yes
    • Motion Control: No (use kling_3_motion / kling_3_motion_pro)
    • Negative prompt: Yes
    • CFG Scale: Yes
    • Duration: integer 3-15 (per-second pricing)
  • Resolution:
    • kling_3: 720p
    • kling_3_pro: 1080p
  • Best for: Latest generation — flexible duration, high quality
For kling_3 and kling_3_pro, send duration as an integer (e.g. 4), not a string. Range: 3-15. Default: 5.
  • Codes: kling_3_motion, kling_3_motion_pro
  • Features:
    • Requires reference video (3-30s) + reference image
    • Duration: Auto-detected from reference video
    • Aspect ratio: Auto-detected from reference video
    • Negative prompt: Yes
    • CFG Scale: Yes
  • Improvements over 2.6 Motion:
    • Better motion fidelity from reference video
    • More realistic physics (hair, clothing, liquids)
    • Fewer artifacts and deformations
    • Better character preservation from reference image
  • Pricing: Per second (same rate as kling_2.6_motion)
  • Best for: Motion transfer — replaces kling_2.6_motion as the recommended model

​
Kling 2.6 Motion Control (Legacy)

  • Codes: kling_2.6_motion, kling_2.6_motion_pro
  • Features:
    • Motion transfer from reference video
    • Requires reference video (3-30s) + reference image
    • Aspect ratio: Auto-detected from video
    • Duration: Auto-detected from video
    • Negative prompt: No
    • CFG Scale: No
  • Pricing:
    • Standard: $0.041/sec
    • Pro: $0.082/sec (2x price)
  • Best for: Transferring motion and style from reference videos

​
Kling 2.6

  • Code: kling_2.6
  • Features:
    • Text-to-video: Yes
    • Image-to-video: Yes
    • Audio support: Yes
    • Always Pro quality
    • Priority processing
    • Negative prompt: No
    • CFG Scale: No
  • Best for: Highest quality videos with audio support

​
Kling 2.5 Turbo (Default)

  • Codes: kling_2.5_turbo, kling_2.5_turbo_pro
  • Features:
    • Text-to-video: Yes
    • Image-to-video: Yes
    • Negative prompt: No
    • CFG Scale: No
  • Best for: Fastest generation speed

​
Kling 2.1 Master

  • Code: kling_2.1_master
  • Features:
    • Text-to-video: Yes
    • Image-to-video: Yes
    • Negative prompt: Yes
    • CFG Scale: No
  • Best for: High-quality text-to-video

​
Kling 2.1 Pro

  • Codes: kling_2.1, kling_2.1_pro
  • Features:
    • Text-to-video: No (image required)
    • Image-to-video: Yes
    • Negative prompt: Yes
    • CFG Scale: No
  • Best for: Professional image animation

​
Kling 1.6

  • Codes: kling_1.6, kling_1.6_pro
  • Features:
    • Text-to-video: Yes
    • Image-to-video: Yes
    • Negative prompt: Yes
    • CFG Scale: Yes
  • Best for: Maximum creative control
Creativity balance parameter (Kling 1.6 only):
  • 0.0-0.3: Maximum creativity, AI adds interpretations
  • 0.4-0.6: Balanced mode (recommended)
  • 0.7-1.0: Strict prompt following, minimal deviations