Kling v2.6 비디오 생성
Generate videos with official Kling v2.6 using explicit reference-image and frame-role semantics
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Async processing mode, returns task ID for subsequent queries
- Supports text-to-video, image-to-video, explicit first/last frame control, and audio video
- Supports standard mode (720P) and professional mode (1080P)
- Professional mode supports automatic audio generation
Authorization
Authorizationstring헤더필수All API endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY요청 파라미터
modelstring본문필수Video generation model name, fixed as kling-v2-6.
promptstring본문필수Text prompt, maximum 2500 characters.
modestring본문기본값: stdGeneration mode.
std- standard mode (720P, silent video only)pro- professional mode (1080P, supports automatic audio generation)
durationinteger본문기본값: 5Video duration in seconds.
Options: 5 or 10
aspect_ratiostring본문기본값: 16:9Video 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_rolesfor 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_framelast_framereferencereference_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].
negative_promptstring본문Negative prompt to exclude unwanted content.
audioboolean본문기본값: falseWhether to automatically generate audio.
Available only in mode: "pro".
watermarkboolean본문Whether to add watermark.
Input Rules
| Input shape | Behavior |
|---|---|
reference_images only | Normal references |
image_with_roles with only first_frame / last_frame | Frame control |
| Both fields used together, or roles include both frame and reference semantics | Mixed mode |
Examples
Text-to-Video
{
"model": "kling-v2-6",
"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-v2-6",
"prompt": "Animate the referenced portrait with a subtle smile",
"reference_images": ["https://example.com/reference.jpg"],
"mode": "std",
"duration": 5
}First and Last Frame Control
{
"model": "kling-v2-6",
"prompt": "City timelapse transitioning from day to night",
"image_with_roles": [
{ "url": "https://example.com/day-city.jpg", "role": "first_frame" },
{ "url": "https://example.com/night-city.jpg", "role": "last_frame" }
],
"mode": "pro",
"duration": 5
}Mixed Reference and Frame Input
{
"model": "kling-v2-6",
"prompt": "Keep the character identity while moving from one scene to another",
"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
}Pro Mode + Auto Audio
{
"model": "kling-v2-6",
"prompt": "Waves crashing against rocks, seagulls circling in the sky, lighthouse in the distance",
"mode": "pro",
"duration": 10,
"audio": true,
"aspect_ratio": "16:9"
}Video generation is an async task. Use the Get Video Task 상태 endpoint to query progress and results.