ToAPIsToAPIs
Kling v3

Kling v3 動画生成

Generate videos with official Kling v3 using explicit reference-image and frame-role semantics

POST
/v1/videos/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • Async task API, returns a task ID after submission
  • Supports text-to-video, image-to-video, explicit first/last frame control, and audio video
  • mode=std maps to 720P, mode=pro maps to 1080P
  • audio=true generates an audio video and is billed as Sound
  • duration supports 3s, 4s, 5s, 6s, 7s, 8s, 9s, 10s, 11s, 12s, 13s, 14s, 15s

Use publicly accessible image URLs. Do not pass base64 image data. Upload local images with the Upload 画像API first.

Authorization

Authorizationstringヘッダー必須

All endpoints require Bearer Token authentication.

Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

modelstringボディ必須

Video generation model name, fixed as kling-v3.

promptstringボディ必須

Text prompt. Describe the subject, action, scene, camera movement, and style.

modestringボディデフォルト: std

Generation mode.

  • std - standard mode, 720P
  • pro - professional mode, 1080P
durationintegerボディデフォルト: 5

Video duration in seconds.

Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

aspect_ratiostringボディデフォルト: 16:9

Video aspect ratio. Common values: 16:9, 9:16, 1:1

reference_imagesstring[]ボディ

Normal reference images.

  • These images are treated as references only
  • They are not automatically converted into first/last frames
  • Use image_with_roles for explicit frame control
image_with_rolesobject[]ボディ

Explicit image-role array for frame control and mixed inputs.

Show image_with_roles object fields
urlstringボディ必須

Publicly accessible image URL.

rolestringボディ必須

Image role.

Supported values:

  • first_frame
  • last_frame
  • reference
  • reference_image

last_frame is only sent when explicitly declared in image_with_roles. The system no longer infers the last frame from reference_images[1].

audiobooleanボディデフォルト: false

Whether to generate an audio video.

metadataobjectボディ

Extended parameters.

Show metadata fields
negative_promptstringボディ

Negative prompt describing content to avoid.

watermarkbooleanボディ

Whether to add watermark.

Input Rules

Input shapeBehavior
reference_images onlyNormal references
image_with_roles with only first_frame / last_frameFrame control
Both fields used together, or roles include both frame and reference semanticsMixed mode

Examples

Text-to-Video

{
  "model": "kling-v3",
  "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Image Reference

{
  "model": "kling-v3",
  "prompt": "Use the reference character and animate a subtle smile",
  "reference_images": ["https://example.com/reference.jpg"],
  "mode": "std",
  "duration": 5
}

First and Last Frame Control

{
  "model": "kling-v3",
  "prompt": "The city naturally transitions from day to night",
  "image_with_roles": [
    { "url": "https://example.com/day.jpg", "role": "first_frame" },
    { "url": "https://example.com/night.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}

Mixed Reference and Frame Input

{
  "model": "kling-v3",
  "prompt": "Keep the character identity consistent while transitioning scenes",
  "reference_images": ["https://example.com/character-reference.jpg"],
  "image_with_roles": [
    { "url": "https://example.com/start-scene.jpg", "role": "first_frame" },
    { "url": "https://example.com/end-scene.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}

Audio Video

{
  "model": "kling-v3",
  "prompt": "A singer performing on stage, crowd cheering, flashing lights",
  "mode": "std",
  "duration": 5,
  "audio": true
}

Video generation is asynchronous. Use the Get Video Task ステータス endpoint to query progress and results.