Skip to main content
POST
Kling v3 動画生成
  • 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

string
必須
All endpoints require Bearer Token authentication.

リクエストパラメータ

string
必須
Video generation model name, fixed as kling-v3.
string
必須
Text prompt. Describe the subject, action, scene, camera movement, and style.
string
デフォルト:"std"
Generation mode.
  • std - standard mode, 720P
  • pro - professional mode, 1080P
integer
デフォルト:"5"
Video duration in seconds.Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
string
デフォルト:"16:9"
Video aspect ratio. Common values: 16:9, 9:16, 1:1
string[]
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
object[]
Explicit image-role array for frame control and mixed inputs.
last_frame is only sent when explicitly declared in image_with_roles. The system no longer infers the last frame from reference_images[1].
boolean
デフォルト:"false"
Whether to generate an audio video.
object
Extended parameters.

Input Rules

Examples

Text-to-Video

Image Reference

First and Last Frame Control

Mixed Reference and Frame Input

Audio Video

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