Kling

Los modelos de Kling se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 15 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

POST

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

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

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

Consultar resultado

GET

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

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

Asíncrono

Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

Modelo	Tarea	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

campos input

promptstringobligatorio

Text prompt for video generation (max 1000 chars)

soundbooleanobligatorio

Specifies whether the generated video contains audio

aspect_ratioenum<string>obligatorio

Defines the video aspect ratio

durationenum<string>obligatorio

Video duration in seconds

Ejemplo

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

campos input

promptstringobligatorio

Text prompt for video generation (max 1000 chars)

image_urlsarray<string>obligatorio

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

soundbooleanobligatorio

Specifies whether the generated video contains audio

durationenum<string>obligatorio

Video duration in seconds

Ejemplo

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

campos input

promptstringobligatorio

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

image_urlstringobligatorio

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

tail_image_urlstringopcional

Tail frame image of video (max 10MB)

durationenum<string>opcional

The duration of the generated video in seconds

negative_promptstringopcional

Elements to exclude from the video (max 500 chars)

cfg_scalenumberopcional

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

Ejemplo

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

campos input

promptstringobligatorio

Text description of video to generate (max 2500 chars)

durationenum<string>opcional

Generated video length in seconds

aspect_ratioenum<string>opcional

Video frame aspect ratio

negative_promptstringopcional

Elements to avoid in generation (max 2500 chars)

cfg_scalenumberopcional

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

Ejemplo

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

campos input

image_urlstringobligatorio

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

audio_urlstringobligatorio

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

promptstringobligatorio

Text direction for video generation (max 5000 chars)

Ejemplo

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

campos input

image_urlstringobligatorio

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

audio_urlstringobligatorio

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

promptstringobligatorio

Text prompt for video generation (max 5000 chars)

Ejemplo

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

campos input

promptstringobligatorio

Text describing the video to generate (max 5000 chars)

image_urlstringobligatorio

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

durationenum<string>opcional

Duration of generated video in seconds

negative_promptstringopcional

Elements to exclude from video generation (max 500 chars)

cfg_scalenumberopcional

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

Ejemplo

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

campos input

promptstringobligatorio

Text describing the video to generate (max 5000 chars)

durationenum<string>opcional

Generated video length in seconds

aspect_ratioenum<string>opcional

Video frame aspect ratio

negative_promptstringopcional

Elements to avoid in video (max 500 chars)

cfg_scalenumberopcional

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

Ejemplo

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

campos input

promptstringobligatorio

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

image_urlstringobligatorio

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

durationstringopcional

Duration of the generated video in seconds

negative_promptstringopcional

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

cfg_scalenumberopcional

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

tail_image_urlstringopcional

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

Ejemplo

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

campos input

promptstringobligatorio

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

image_urlstringobligatorio

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

durationstringopcional

Length of generated video in seconds

negative_promptstringopcional

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

cfg_scalenumberopcional

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

Ejemplo

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

campos input

promptstringopcional

Text description of desired output (max 2500 chars)

input_urlsarray<string>obligatorio

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

video_urlsarray<string>obligatorio

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

character_orientationstringobligatorio

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

modestringobligatorio

Output resolution: 720p or 1080p

Ejemplo

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

campos input

promptstringopcional

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

input_urlsarray<string>obligatorio

URL of the reference image showing the subject

video_urlsarray<string>obligatorio

URL of the motion video defining the motion pattern

modestringopcional

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

character_orientationstringopcional

Reference for character orientation (video recommended)

background_sourcestringopcional

Background source selection

Ejemplo

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

campos input

promptstringopcional

Video generation prompt (single-shot mode)

image_urlsarray<string>opcional

First/last frame image URLs for reference

soundbooleanopcional

Enable/disable sound effects for video

durationstringobligatorio

Total video duration in seconds (3-15)

aspect_ratiostringopcional

Video aspect ratio; auto-adapts if images provided

modestringopcional

Generation mode controlling resolution output

multi_shotsbooleanopcional

Enable multi-shot mode for multiple shots

multi_promptarray<object>opcional

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

kling_elementsarray<object>opcional

Referenced elements (images/video/audio) max 3

Ejemplo

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

campos input

promptstringobligatorio

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

durationstringobligatorio

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

aspect_ratiostringobligatorio

Aspect ratio of the generated video frame

resolutionstringobligatorio

Resolution of the generated video

Ejemplo

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

campos input

promptstringobligatorio

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

image_urlsarray<string>obligatorio

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

durationstringopcional

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

resolutionstringopcional

Output video resolution

Ejemplo

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"
  }
}'