マーケットサポート← アプリに戻る

Kling

Kling モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 15 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

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

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

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

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
KlingText to Videokling/text-to-video
KlingImage to Videokling/image-to-video
Kling V25 TurboImage to Videokling/v25-turbo-image-to-video-pro
Kling V25 TurboText to Videokling/v25-turbo-text-to-video-pro
KlingLip Synckling/ai-avatar-standard
KlingLip Synckling/ai-avatar-pro
Kling V2 1 MasterImage to Videokling/v2-1-master-image-to-video
Kling V2 1 MasterText to Videokling/v2-1-master-text-to-video
Kling V2 1 ProImage to Videokling/v2-1-pro
Kling V2 1 StandardImage to Videokling/v2-1-standard
KlingImage to Videokling/motion-control
KlingImage to Videokling/motion-control-v3
Kling 3.0Image to Videokling/kling-3-0
Kling V3 TurboText to Videokling/v3-turbo-text-to-video
Kling V3 TurboImage to Videokling/v3-turbo-image-to-video

Kling · Text to Video

POSTText to Videokling/text-to-video
input フィールド
promptstring必須

Text prompt for video generation (max 1000 chars)

soundboolean必須

Specifies whether the generated video contains audio

aspect_ratioenum<string>必須

Defines the video aspect ratio

durationenum<string>必須

Video duration in seconds

例
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 フィールド
promptstring必須

Text prompt for video generation (max 1000 chars)

image_urlsarray<string>必須

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

soundboolean必須

Specifies whether the generated video contains audio

durationenum<string>必須

Video duration in seconds

例
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 フィールド
promptstring必須

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

image_urlstring必須

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

tail_image_urlstring任意

Tail frame image of video (max 10MB)

durationenum<string>任意

The duration of the generated video in seconds

negative_promptstring任意

Elements to exclude from the video (max 500 chars)

cfg_scalenumber任意

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

例
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 フィールド
promptstring必須

Text description of video to generate (max 2500 chars)

durationenum<string>任意

Generated video length in seconds

aspect_ratioenum<string>任意

Video frame aspect ratio

negative_promptstring任意

Elements to avoid in generation (max 2500 chars)

cfg_scalenumber任意

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

例
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 フィールド
image_urlstring必須

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

audio_urlstring必須

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

promptstring必須

Text direction for video generation (max 5000 chars)

例
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 フィールド
image_urlstring必須

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

audio_urlstring必須

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

promptstring必須

Text prompt for video generation (max 5000 chars)

例
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 フィールド
promptstring必須

Text describing the video to generate (max 5000 chars)

image_urlstring必須

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

durationenum<string>任意

Duration of generated video in seconds

negative_promptstring任意

Elements to exclude from video generation (max 500 chars)

cfg_scalenumber任意

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

例
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 フィールド
promptstring必須

Text describing the video to generate (max 5000 chars)

durationenum<string>任意

Generated video length in seconds

aspect_ratioenum<string>任意

Video frame aspect ratio

negative_promptstring任意

Elements to avoid in video (max 500 chars)

cfg_scalenumber任意

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

例
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 フィールド
promptstring必須

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

image_urlstring必須

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

durationstring任意

Duration of the generated video in seconds

negative_promptstring任意

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

cfg_scalenumber任意

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

tail_image_urlstring任意

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

例
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 フィールド
promptstring必須

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

image_urlstring必須

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

durationstring任意

Length of generated video in seconds

negative_promptstring任意

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

cfg_scalenumber任意

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

例
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 フィールド
promptstring任意

Text description of desired output (max 2500 chars)

input_urlsarray<string>必須

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

video_urlsarray<string>必須

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

character_orientationstring必須

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

modestring必須

Output resolution: 720p or 1080p

例
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 フィールド
promptstring任意

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

input_urlsarray<string>必須

URL of the reference image showing the subject

video_urlsarray<string>必須

URL of the motion video defining the motion pattern

modestring任意

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

character_orientationstring任意

Reference for character orientation (video recommended)

background_sourcestring任意

Background source selection

例
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 フィールド
promptstring任意

Video generation prompt (single-shot mode)

image_urlsarray<string>任意

First/last frame image URLs for reference

soundboolean任意

Enable/disable sound effects for video

durationstring必須

Total video duration in seconds (3-15)

aspect_ratiostring任意

Video aspect ratio; auto-adapts if images provided

modestring任意

Generation mode controlling resolution output

multi_shotsboolean任意

Enable multi-shot mode for multiple shots

multi_promptarray<object>任意

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

kling_elementsarray<object>任意

Referenced elements (images/video/audio) max 3

例
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 フィールド
promptstring必須

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

durationstring必須

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

aspect_ratiostring必須

Aspect ratio of the generated video frame

resolutionstring必須

Resolution of the generated video

例
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 フィールド
promptstring必須

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

image_urlsarray<string>必須

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

durationstring任意

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

resolutionstring任意

Output video resolution

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