Kling

Kling models are called through one unified, asynchronous job API. Start a task with POST /api/generate, then poll GET /api/generate/{taskId} until it finishes. This family exposes 15 endpoints.

Overview

Every endpoint shares the same envelope — only model and the input fields change. Run any from the Models Market playground.

Authentication

Create an API key at /api-keys, then send it as a Bearer token. Requests from the browser while logged in also work via the session cookie.

Authorization: Bearer <YOUR_API_KEY>

Create Task

POST

POST https://api.lithovas.com/api/generate

Body: { "model": "<slug>", "input": { … } }

Response: { "taskId": "<id>", "state": "waiting" }

Query Result

GET

GET https://api.lithovas.com/api/generate/<taskId>

Response: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asynchronous

A 200 from Create Task only means the task was accepted — not finished. Poll this endpoint until state becomes success or fail. Failed tasks are not billed.

Endpoints

Model	Task	model slug
Kling	Text to Video	kling/text-to-video
Kling	Image to Video	kling/image-to-video
Kling V25 Turbo	Image to Video	kling/v25-turbo-image-to-video-pro
Kling V25 Turbo	Text to Video	kling/v25-turbo-text-to-video-pro
Kling	Lip Sync	kling/ai-avatar-standard
Kling	Lip Sync	kling/ai-avatar-pro
Kling V2 1 Master	Image to Video	kling/v2-1-master-image-to-video
Kling V2 1 Master	Text to Video	kling/v2-1-master-text-to-video
Kling V2 1 Pro	Image to Video	kling/v2-1-pro
Kling V2 1 Standard	Image to Video	kling/v2-1-standard
Kling	Image to Video	kling/motion-control
Kling	Image to Video	kling/motion-control-v3
Kling 3.0	Image to Video	kling/kling-3-0
Kling V3 Turbo	Text to Video	kling/v3-turbo-text-to-video
Kling V3 Turbo	Image to Video	kling/v3-turbo-image-to-video

Kling · Text to Video

POSTText to Videokling/text-to-video

input fields

promptstringrequired

Text prompt for video generation (max 1000 chars)

soundbooleanrequired

Specifies whether the generated video contains audio

aspect_ratioenum<string>required

Defines the video aspect ratio

durationenum<string>required

Video duration in seconds

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "sound": false,
    "aspect_ratio": "1:1",
    "duration": "5"
  }
}'

Kling · Image to Video

POSTImage to Videokling/image-to-video

input fields

promptstringrequired

Text prompt for video generation (max 1000 chars)

image_urlsarray<string>required

Image URLs for video generation; max 1 file, JPEG/PNG, max 10MB

soundbooleanrequired

Specifies whether the generated video contains audio

durationenum<string>required

Video duration in seconds

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "sound": false,
    "duration": "5"
  }
}'

Kling V25 Turbo · Image to Video

POSTImage to Videokling/v25-turbo-image-to-video-pro

input fields

promptstringrequired

Text prompt describing the video to generate (max 2500 chars)

image_urlstringrequired

URL of the image to be used for the video (max 10MB)

tail_image_urlstringoptional

Tail frame image of video (max 10MB)

durationenum<string>optional

The duration of the generated video in seconds

negative_promptstringoptional

Elements to exclude from the video (max 500 chars)

cfg_scalenumberoptional

CFG scale controlling adherence to prompt (0-1, step 0.1)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v25-turbo-image-to-video-pro",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "tail_image_url": "https://example.com/input.jpg",
    "duration": "5",
    "negative_prompt": "example",
    "cfg_scale": 0.5
  }
}'

Kling V25 Turbo · Text to Video

POSTText to Videokling/v25-turbo-text-to-video-pro

input fields

promptstringrequired

Text description of video to generate (max 2500 chars)

durationenum<string>optional

Generated video length in seconds

aspect_ratioenum<string>optional

Video frame aspect ratio

negative_promptstringoptional

Elements to avoid in generation (max 2500 chars)

cfg_scalenumberoptional

Guidance scale controlling prompt adherence (0-1, step 0.1)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v25-turbo-text-to-video-pro",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "example",
    "cfg_scale": 0.5
  }
}'

Kling · Lip Sync

POSTLip Synckling/ai-avatar-standard

input fields

image_urlstringrequired

URL of the image to use as your avatar (JPEG/PNG, max 10MB)

audio_urlstringrequired

URL of the audio file (MP3/WAV/AAC/M4A/OGG, max 100MB, 5min)

promptstringrequired

Text direction for video generation (max 5000 chars)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/ai-avatar-standard",
  "input": {
    "image_url": "https://example.com/input.jpg",
    "audio_url": "https://example.com/reference.mp3",
    "prompt": "A cinematic red panda surfing through neon rain at dusk."
  }
}'

Kling · Lip Sync

POSTLip Synckling/ai-avatar-pro

input fields

image_urlstringrequired

URL of image file to use as avatar (JPEG/PNG, max 10MB)

audio_urlstringrequired

URL of audio file for speech (MP3/WAV/AAC/MP4/OGG, max 100MB, 5min)

promptstringrequired

Text prompt for video generation (max 5000 chars)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/ai-avatar-pro",
  "input": {
    "image_url": "https://example.com/input.jpg",
    "audio_url": "https://example.com/reference.mp3",
    "prompt": "A cinematic red panda surfing through neon rain at dusk."
  }
}'

Kling V2 1 Master · Image to Video

POSTImage to Videokling/v2-1-master-image-to-video

input fields

promptstringrequired

Text describing the video to generate (max 5000 chars)

image_urlstringrequired

URL of image for video generation (JPEG/PNG, max 10MB)

durationenum<string>optional

Duration of generated video in seconds

negative_promptstringoptional

Elements to exclude from video generation (max 500 chars)

cfg_scalenumberoptional

Guidance scale controlling prompt adherence (0-1, step 0.1)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v2-1-master-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "5",
    "negative_prompt": "example",
    "cfg_scale": 0.5
  }
}'

Kling V2 1 Master · Text to Video

POSTText to Videokling/v2-1-master-text-to-video

input fields

promptstringrequired

Text describing the video to generate (max 5000 chars)

durationenum<string>optional

Generated video length in seconds

aspect_ratioenum<string>optional

Video frame aspect ratio

negative_promptstringoptional

Elements to avoid in video (max 500 chars)

cfg_scalenumberoptional

Guidance scale adherence to prompt (0-1, step 0.1)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v2-1-master-text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "example",
    "cfg_scale": 0.5
  }
}'

Kling V2 1 Pro · Image to Video

POSTImage to Videokling/v2-1-pro

input fields

promptstringrequired

Text prompt describing the video to generate (max 5000 chars)

image_urlstringrequired

URL of the image to be used for the video (max 10MB)

durationstringoptional

Duration of the generated video in seconds

negative_promptstringoptional

Terms to avoid in the generated video (max 500 chars)

cfg_scalenumberoptional

CFG scale measuring adherence to prompt (0-1, step 0.1)

tail_image_urlstringoptional

URL of the image for the end of the video (max 10MB)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v2-1-pro",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "5",
    "negative_prompt": "example",
    "cfg_scale": 0.5,
    "tail_image_url": "https://example.com/input.jpg"
  }
}'

Kling V2 1 Standard · Image to Video

POSTImage to Videokling/v2-1-standard

input fields

promptstringrequired

Text prompt describing the desired video content (max 5000 chars)

image_urlstringrequired

URL of the image to be used for the video (max 10MB)

durationstringoptional

Length of generated video in seconds

negative_promptstringoptional

Elements to avoid in the generated video (max 500 chars)

cfg_scalenumberoptional

Guidance scale controlling prompt adherence (0-1, step 0.1)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v2-1-standard",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "5",
    "negative_prompt": "example",
    "cfg_scale": 0.5
  }
}'

Kling · Image to Video

POSTImage to Videokling/motion-control

input fields

promptstringoptional

Text description of desired output (max 2500 chars)

input_urlsarray<string>required

Single image URL showing subject's head, shoulders, torso

video_urlsarray<string>required

Single video URL (3-30s) showing subject's head, shoulders, torso

character_orientationstringrequired

Character orientation: image for picture pose or video for video pose

modestringrequired

Output resolution: 720p or 1080p

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/motion-control",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "input_urls": [
      "https://example.com/file"
    ],
    "video_urls": [
      "https://example.com/reference.mp4"
    ],
    "character_orientation": "image",
    "mode": "720p"
  }
}'

Kling · Image to Video

POSTImage to Videokling/motion-control-v3

input fields

promptstringoptional

Text prompt (0-2500 chars) to guide animation generation

input_urlsarray<string>required

URL of the reference image showing the subject

video_urlsarray<string>required

URL of the motion video defining the motion pattern

modestringoptional

Video quality: std (720p) or pro (1080p)

character_orientationstringoptional

Reference for character orientation (video recommended)

background_sourcestringoptional

Background source selection

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/motion-control-v3",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "input_urls": [
      "https://example.com/file"
    ],
    "video_urls": [
      "https://example.com/reference.mp4"
    ],
    "mode": "std",
    "character_orientation": "video",
    "background_source": "input_video"
  }
}'

Kling 3.0 · Image to Video

POSTImage to Videokling/kling-3-0

input fields

promptstringoptional

Video generation prompt (single-shot mode)

image_urlsarray<string>optional

First/last frame image URLs for reference

soundbooleanoptional

Enable/disable sound effects for video

durationstringrequired

Total video duration in seconds (3-15)

aspect_ratiostringoptional

Video aspect ratio; auto-adapts if images provided

modestringoptional

Generation mode controlling resolution output

multi_shotsbooleanoptional

Enable multi-shot mode for multiple shots

multi_promptarray<object>optional

Shot array with prompt/duration (multi-shot mode)

kling_elementsarray<object>optional

Referenced elements (images/video/audio) max 3

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/kling-3-0",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "sound": false,
    "duration": 5,
    "aspect_ratio": "16:9",
    "mode": "pro",
    "multi_shots": false,
    "multi_prompt": [],
    "kling_elements": []
  }
}'

Kling V3 Turbo · Text to Video

POSTText to Videokling/v3-turbo-text-to-video

input fields

promptstringrequired

Text description of the video to generate (max 2500 chars)

durationstringrequired

Duration of generated video in seconds (3s-15s range)

aspect_ratiostringrequired

Aspect ratio of the generated video frame

resolutionstringrequired

Resolution of the generated video

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v3-turbo-text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }
}'

Kling V3 Turbo · Image to Video

POSTImage to Videokling/v3-turbo-image-to-video

input fields

promptstringrequired

Text prompt describing the video to generate (max 2500 chars)

image_urlsarray<string>required

URL of image for video (JPEG/PNG, max 10MB)

durationstringoptional

Video duration in seconds (3s-15s range)

resolutionstringoptional

Output video resolution

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling/v3-turbo-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "duration": 5,
    "resolution": "720p"
  }
}'