﻿> ## Documentation Index
>
> Fetch the complete documentation index at: https://kling.ai/document-api/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling 4.0 Video Prompt Guide

> Source: https://kling.ai/document-api/api/usage-guide/kling-4-0-prompt-guide
> Locale: en
> Current Tab: Kling 4.0 Video Prompt Guide
> This content is optimized for LLMs. In-page tabs are expanded and UI-only controls are omitted.

::: info-box

This article provides prompt examples to accompany the Kling 4.0 Video User Guide, which explains Kling 4.0's model capabilities, how to use API tasks, input asset requirements, and prompt-writing techniques in detail. The examples cover various Kling 4.0 features, each with a complete prompt and runnable API code. You can copy and try them as provided or adapt them to your specific business needs.

## 1.Character and Scene Reference

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-full">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-011.1b0d2d26ce00d558.15300cebf5ead6f5.webp" alt="" /></div>

</div>
</div>

```text
[Overall Style] 15 seconds, realistic live-action cinematic quality. A coastal city street at dusk connects to a staged banquet scene. Natural handheld cinematography with noticeable vertical movement from footsteps, subtle irregular shake, and framing corrections. Whip pans follow vehicle and character movements, producing brief motion blur before settling back on the target. Movement is intense during the car chase and running sequences, then gradually slows during the banquet sequence. Characters have slight perspiration, loose strands of hair, and natural clothing wrinkles. Road surfaces, clothing, and equipment show realistic signs of use. Natural colors create visual contrast between the red sports car, flames, and the warm tones of the banquet.
[Characters and Vehicles]
Male Actor: Around 30 years old, with short dark hair, light stubble, and a lean, athletic build. While driving and rolling on the ground, he wears a complete spy-action outfit: A fitted dark charcoal-gray tactical top with a closed neckline; Matching tactical trousers; Black leather ankle boots. The outer costume has tear-away seams designed for quick changes on set. The top opens along the center front and both sides, while the trousers open along the outer seams of both legs. A white shirt, black bow tie, and dark navy dress trousers are already worn underneath the outer costume. When the outer costume remains intact, he clearly appears in the dark tactical outfit. Two additional crew members help him put on the suit jacket later. The hems of the navy dress trousers cover the shafts of the black ankle boots. The actor's face, hairstyle, and physique must remain consistent throughout.
Sports Car: An original red concept sports car with a low, rounded wedge-shaped body, a short front end, a curved cockpit, and wide rear wheel arches. The front features a continuous horizontal white light bar. The rear has three small circular taillights on each side. The center of the hood is uninterrupted, smooth red paint. The dark gray wheels have plain metal center caps. The center of the steering wheel has a solid black leather surface. The driver's side window is open. The car's overall shape and lighting design must remain consistent across all shots.
Motorcycle Camera Operator: Wearing dark workwear and a protective helmet, he stands alone on both stunt footpegs of a dark blue sport motorcycle, with his hips higher than the seat. He holds a camera on his shoulder with both hands, leaving the handlebars unoccupied. He controls the motorcycle using his legs and center of gravity, compensating for bumps with his upper body. The camera is aimed at the sports car's driver. During the reveal, his full standing posture, both feet, the motorcycle, and the camera must all be clearly visible.
Director: In his forties, with some gray hair and naturally textured facial features. He wears a worn-in, short dark brown jacket over a beige crew-neck T-shirt, paired with dark straight-leg trousers. He holds a digital stopwatch, actively turning his body and gaze to follow the filming action. A script supervisor, camera assistants, and lighting crew stand nearby. People and equipment in the foreground, beside him, and in the distance create layered depth.
Wardrobe Crew: Six crew members in ordinary on-set workwear. The first four, two on the left and two on the right, pull open and remove the outer tactical costume. The remaining two unfold and help him put on the dark navy suit jacket. Each person performs a clearly defined action. After removing a garment, the corresponding crew member holds it in their hands.
Female Companion: Wearing a champagne-gold evening gown and holding her own champagne flute. She stands a few steps inside the banquet entrance.
Waiter: Standing to one side of the entrance, holding a tray of champagne flutes for the male actor to pick one up as he passes.
[Shots and Actions]
00:00–00:03 | Five Rapid Cuts During the Car Chase Tire close-up: The rear tire grips the road as the red sports car accelerates. Foot close-up: The actor's black leather boot presses down on the accelerator. Eye close-up: The actor quickly assesses the traffic ahead, his face vibrating with the movement of the car. Hand close-up: Both hands turn the steering wheel decisively. Slightly wider side shot: The sports car squeezes past an adjacent vehicle, rapidly closing the gap before pulling away again. The first four shots are brief and punchy. Let the final shot run slightly longer to clearly establish the car weaving through traffic.
00:03–00:09 | Pull Out of the Car, Reveal the Camera Operator, Whip Pan to the Director Film the driver from near the passenger seat. The camera moves through the open driver's side window, fully exits the car, and continues pulling outward. Establish a wide exterior side view: The red sports car and dark blue motorcycle travel side by side. The camera operator is fully visible from head to toe, standing alone with the camera on his shoulder, aimed directly at the driver. The sports car steers around a vehicle ahead. The motorcycle leans into the turn in sync, then returns to parallel alignment. The camera naturally bobs with the speed and road bumps. As the vehicles pass the director's working area, the camera whips toward the roadside. A camera assistant's shoulder briefly sweeps through the foreground before the camera settles into an oblique medium close-up of the director. The director leans forward, his gaze tracking the sports car. A script supervisor takes notes beside him, while lighting crew and equipment in the distance create a deep, layered production-set background. He gestures forward and shouts: "Stay with it! Keep going!" The entire line must be delivered while the director is on screen.
00:09–00:12 | Sports Car Explosion Cut to a wider tracking shot alongside the sports car. A missile with a visible flaming trail enters from the rear left and clearly strikes the rear of the car. A flash erupts at the point of impact, followed immediately by an explosion at the rear of the vehicle. Flames, black smoke, and debris expand outward. The car body is thrown upward while continuing its momentum toward the right. The handheld camera jolts briefly from the impact.
00:12–00:14 | The Actor Rolls into Frame from the Left Cut to the ground near the adjacent film set. Wearing the complete dark tactical outfit, the actor rolls close to the ground into frame from the left, moving toward the center. Burning flames and rising smoke remain visible in the rear left. Orange light sweeps across his left shoulder, the side of his face, and the ground. He finishes in a heroic kneeling pose, with one knee on the ground and one hand braced against the ground. His entire body remains visible, and his clothes are covered in dust. The camera briefly dips with his landing, then readjusts to find the actor.
00:14–00:15 | Facial Close-Up Leading into the Run Cut to the actor's face. He exhales, with sweat and dust visible on his face and flickering firelight on his left side. He raises his eyes and locks his gaze on something ahead. His shoulders lift, and his body begins to launch into a run. The handheld camera makes small natural movements and quickly rises with him as he gets up, transitioning into the running sequence.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-015.d3ba58b7fba6e405.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-015.87072260fac50780.faae947c593036d7.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "[Overall Style] 15 seconds, realistic live-action cinematic quality. A coastal city street at dusk connects to a staged banquet scene. Natural handheld cinematography with noticeable vertical movement from footsteps, subtle irregular shake, and framing corrections. Whip pans follow vehicle and character movements, producing brief motion blur before settling back on the target. Movement is intense during the car chase and running sequences, then gradually slows during the banquet sequence. Characters have slight perspiration, loose strands of hair, and natural clothing wrinkles. Road surfaces, clothing, and equipment show realistic signs of use. Natural colors create visual contrast between the red sports car, flames, and the warm tones of the banquet. [Characters and Vehicles] Male Actor: Around 30 years old, with short dark hair, light stubble, and a lean, athletic build. While driving and rolling on the ground, he wears a complete spy-action outfit: A fitted dark charcoal-gray tactical top with a closed neckline; Matching tactical trousers; Black leather ankle boots. The outer costume has tear-away seams designed for quick changes on set. The top opens along the center front and both sides, while the trousers open along the outer seams of both legs. A white shirt, black bow tie, and dark navy dress trousers are already worn underneath the outer costume. When the outer costume remains intact, he clearly appears in the dark tactical outfit. Two additional crew members help him put on the suit jacket later. The hems of the navy dress trousers cover the shafts of the black ankle boots. The actor'\''s face, hairstyle, and physique must remain consistent throughout. Sports Car: An original red concept sports car with a low, rounded wedge-shaped body, a short front end, a curved cockpit, and wide rear wheel arches. The front features a continuous horizontal white light bar. The rear has three small circular taillights on each side. The center of the hood is uninterrupted, smooth red paint. The dark gray wheels have plain metal center caps. The center of the steering wheel has a solid black leather surface. The driver'\''s side window is open. The car'\''s overall shape and lighting design must remain consistent across all shots. Motorcycle Camera Operator: Wearing dark workwear and a protective helmet, he stands alone on both stunt footpegs of a dark blue sport motorcycle, with his hips higher than the seat. He holds a camera on his shoulder with both hands, leaving the handlebars unoccupied. He controls the motorcycle using his legs and center of gravity, compensating for bumps with his upper body. The camera is aimed at the sports car'\''s driver. During the reveal, his full standing posture, both feet, the motorcycle, and the camera must all be clearly visible. Director: In his forties, with some gray hair and naturally textured facial features. He wears a worn-in, short dark brown jacket over a beige crew-neck T-shirt, paired with dark straight-leg trousers. He holds a digital stopwatch, actively turning his body and gaze to follow the filming action. A script supervisor, camera assistants, and lighting crew stand nearby. People and equipment in the foreground, beside him, and in the distance create layered depth. Wardrobe Crew: Six crew members in ordinary on-set workwear. The first four, two on the left and two on the right, pull open and remove the outer tactical costume. The remaining two unfold and help him put on the dark navy suit jacket. Each person performs a clearly defined action. After removing a garment, the corresponding crew member holds it in their hands. Female Companion: Wearing a champagne-gold evening gown and holding her own champagne flute. She stands a few steps inside the banquet entrance. Waiter: Standing to one side of the entrance, holding a tray of champagne flutes for the male actor to pick one up as he passes. [Shots and Actions] 00:00–00:03 | Five Rapid Cuts During the Car Chase Tire close-up: The rear tire grips the road as the red sports car accelerates. Foot close-up: The actor'\''s black leather boot presses down on the accelerator. Eye close-up: The actor quickly assesses the traffic ahead, his face vibrating with the movement of the car. Hand close-up: Both hands turn the steering wheel decisively. Slightly wider side shot: The sports car squeezes past an adjacent vehicle, rapidly closing the gap before pulling away again. The first four shots are brief and punchy. Let the final shot run slightly longer to clearly establish the car weaving through traffic. 00:03–00:09 | Pull Out of the Car, Reveal the Camera Operator, Whip Pan to the Director Film the driver from near the passenger seat. The camera moves through the open driver'\''s side window, fully exits the car, and continues pulling outward. Establish a wide exterior side view: The red sports car and dark blue motorcycle travel side by side. The camera operator is fully visible from head to toe, standing alone with the camera on his shoulder, aimed directly at the driver. The sports car steers around a vehicle ahead. The motorcycle leans into the turn in sync, then returns to parallel alignment. The camera naturally bobs with the speed and road bumps. As the vehicles pass the director'\''s working area, the camera whips toward the roadside. A camera assistant'\''s shoulder briefly sweeps through the foreground before the camera settles into an oblique medium close-up of the director. The director leans forward, his gaze tracking the sports car. A script supervisor takes notes beside him, while lighting crew and equipment in the distance create a deep, layered production-set background. He gestures forward and shouts: \"Stay with it! Keep going!\" The entire line must be delivered while the director is on screen. 00:09–00:12 | Sports Car Explosion Cut to a wider tracking shot alongside the sports car. A missile with a visible flaming trail enters from the rear left and clearly strikes the rear of the car. A flash erupts at the point of impact, followed immediately by an explosion at the rear of the vehicle. Flames, black smoke, and debris expand outward. The car body is thrown upward while continuing its momentum toward the right. The handheld camera jolts briefly from the impact. 00:12–00:14 | The Actor Rolls into Frame from the Left Cut to the ground near the adjacent film set. Wearing the complete dark tactical outfit, the actor rolls close to the ground into frame from the left, moving toward the center. Burning flames and rising smoke remain visible in the rear left. Orange light sweeps across his left shoulder, the side of his face, and the ground. He finishes in a heroic kneeling pose, with one knee on the ground and one hand braced against the ground. His entire body remains visible, and his clothes are covered in dust. The camera briefly dips with his landing, then readjusts to find the actor. 00:14–00:15 | Facial Close-Up Leading into the Run Cut to the actor'\''s face. He exhales, with sweat and dust visible on his face and flickering firelight on his left side. He raises his eyes and locks his gaze on something ahead. His shoulders lift, and his body begins to launch into a run. The handheld camera makes small natural movements and quickly rises with him as he gets up, transitioning into the running sequence."
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_1_cast_vehicle_board.jpg",
      "id": "Image1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 2.Action Reference

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-video-full">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-016.cc8c356ec1c6c121.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-016.21a0b5ce8eff387f.048aa3c189f3e44e.webp" alt="" /></button>

<p>Video 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-016.e15f59cc63d6ab02.42d6d6f3c780da99.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-009.9acc77940efcd8d3.c06141c07ec71c8e.webp" alt="" /></div>

<p>Image 2</p>
</div>
</div>

```text
Reference the fighting moves and attack timing in @Video1. Use @Image1 and @Image2 as the character design references.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-019.3ad1e32412b47d91.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-019.cf68c76a37e91287.3108f99e5376fbe1.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Reference the fighting moves and attack timing in @Video1. Use @Image1 and @Image2 as the character design references."
    },
    {
      "type": "feature_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_2_fight_motion_source.mp4",
      "id": "Video1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_2_dark_hair_fighter_ref.png",
      "id": "Image1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_2_silver_hair_fighter_ref.png",
      "id": "Image2"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 3.Camera Movement Reference

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-video-full">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-010.7bb89958b181873a.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-010.72ab0b48df407eb0.fe247de10099928c.webp" alt="" /></button>

<p>Video 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-013.2af59253fbf53d04.3fddf62627ace5e2.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-017.9d48f22b4a55896f.9c50dbab3d2dec14.webp" alt="" /></div>

<p>Image 2</p>
</div>
</div>

```text
Reference the camera path and pacing of @Video1. Replace the subject with the car in @Image1 and the background with @Image2.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-017.8941d03fa769a2e0.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-017.0b611dc3bcf16c7a.38fc002aba07c08f.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Reference the camera path and pacing of @Video1. Replace the subject with the car in @Image1 and the background with @Image2."
    },
    {
      "type": "feature_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_3_camera_motion_source.mp4",
      "id": "Video1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_3_race_car_ref.png",
      "id": "Image1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_3_neon_arena_ref.png",
      "id": "Image2"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 4.Storyboard Reference

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-014.b11db9adc74cdb94.2983a857e74f4983.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-012.9ac826fa72bf4c8b.8c82cafeee087bc4.webp" alt="" /></div>

<p>Image 2</p>
</div>
</div>

```text
Strictly follow the attached storyboard (@Image1) as the basis. Adhere to the director-approved shot order, composition, camera paths, screen direction, and emotional progression. Present the final stop-motion-style frames described in each storyboard panel — do not film the storyboard itself. The footage must not contain pencil-sketch textures, storyboard grids, title bars, Chinese annotations, or director's notes.
The attached character design sheet (@Image2) is the sole authoritative reference for BISCUIT (C1): a small, round, plump clay terrier with tousled brown fur, one floppy ear and one upright ear, a large black clay nose, wide-open, expectant eyes, and a short tail. He wears a tiny white clay spacesuit with orange collars and cuffs; his round glass helmet is open at the front, allowing his nose to stick out. He carries a small backpack with a curved antenna, wears oversized moon boots, and holds a clay fork larger than himself. The same dog, spacesuit, and fork must remain visually consistent in every frame. C2 is a friendly clay cheese mouse as large as a bus.
Duration: 15 seconds, aspect ratio 16:9. The entire sequence must be one continuous master shot with no visible cuts. A single virtual camera first bobs alongside him as he jumps, then dives into the hole with him, tilts upward from the bottom of the tunnel, follows him as he bursts out of the hole, and finally rises to an extreme long shot. All changes in shot scale must be achieved through this continuous camera movement.
Visual style: Handcrafted clay stop-motion animation in the style of Aardman Animations. Preserve clearly visible fingerprints, clay textures, and slightly uneven surfaces, with the characteristic stepped motion of 12 fps stop-motion animation. Use lighting that resembles a real miniature set and macro-photography-style shallow depth of field. The cheese moon wobbles like jelly. The sky is made of black felt, decorated with tin-foil stars and a clay Earth. The overall atmosphere is warm, cozy, and whimsical.
Visual concept: Hunger and courage. A little dog, an enormous fork, a wobbling cheese moon, and a new friend.
Environment: A yellow cheese moon riddled with holes, underground cheese tunnels, a small crooked clay rocket, and Earth in the sky.
Audio: No music for the first 12 seconds. During the final three seconds, a cheerful tuba and ukulele duet plays. Sound effects include squeaky clay footsteps, springy "boing-whoing" sounds during slow, low-gravity jumps, deep jelly-like rumbles as the moon shakes, a rubbery "pop" as the hole opens, a rushing whoosh during tumbling, loud chewing from the giant mouse and a startled squeal, frantic paw-scratching sounds, a satisfying bite as Biscuit finally gets his cheese, contented chewing, and the sound of his tail thumping against the ground.
Emotional progression: L1 Curiosity → L3 Surprise → L4 Panic → L5 Chase at its peak → L5 Ecstatic bliss at the first bite of cheese → L1 Warmth and contentment.
Storyboard beats (continuous throughout, no cuts):
0–2 seconds (P01): The camera stays close to the cheese surface at a low angle. Biscuit steps out of the crooked little rocket and plants one paw on the cheese. He sniffs it, and his eyes grow wider with anticipation. He carries the fork over his shoulder, and Earth is visible in the sky.
2–4.5 seconds (P02): The camera bobs alongside him with each jump. He makes slow, exaggerated low-gravity leaps across the cheese landscape, his ears bouncing and flapping upward. He plunges his fork into a large wedge of cheese, and the entire surface immediately wobbles like jelly as a gigantic hole opens beneath his feet.
4.5–7 seconds (P03): The camera dives into the hole alongside him. Still gripping his fork, Biscuit tumbles slowly through a hole-riddled cheese tunnel, passing a gigantic clay cheese mouse as large as a bus that is busy nibbling on the tunnel wall. Biscuit's appearance startles the mouse.
7–9.5 seconds (P04): The camera reaches the bottom of the tunnel and tilts upward. The giant mouse turns around, its whiskers trembling, and chases Biscuit up the tunnel. Panicking, Biscuit ricochets between the tunnel walls, with curly ribbons of cheese trailing behind his fork.
9.5–12 seconds (P05): The camera follows them as they burst out of the hole. Biscuit launches upward in a slow, high arc, and the giant mouse's head emerges from the opening immediately behind him. Suspended upside down in midair, Biscuit scoops up a huge curl of cheese with his fork and puts it into his mouth, instantly experiencing overwhelming bliss.
12–15 seconds (P06): The camera rises and pulls back into an extreme long shot. Biscuit and the giant mouse sit side by side on the edge of the hole, happily sharing cheese. The rocket rests behind them, Earth slowly rises in the distance, and tin-foil stars dot the sky. Biscuit exhales contentedly, fogging up his helmet glass, while his tail wags happily. The tuba and ukulele duet begins. Hold on this final composition.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-014.fd48640b3be4c4f4.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-014.6e3a2aa695c37ba3.c913c69a1e69ccfb.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Strictly follow the attached storyboard (@Image1) as the basis. Adhere to the director-approved shot order, composition, camera paths, screen direction, and emotional progression. Present the final stop-motion-style frames described in each storyboard panel — do not film the storyboard itself. The footage must not contain pencil-sketch textures, storyboard grids, title bars, Chinese annotations, or director'\''s notes. The attached character design sheet (@Image2) is the sole authoritative reference for BISCUIT (C1): a small, round, plump clay terrier with tousled brown fur, one floppy ear and one upright ear, a large black clay nose, wide-open, expectant eyes, and a short tail. He wears a tiny white clay spacesuit with orange collars and cuffs; his round glass helmet is open at the front, allowing his nose to stick out. He carries a small backpack with a curved antenna, wears oversized moon boots, and holds a clay fork larger than himself. The same dog, spacesuit, and fork must remain visually consistent in every frame. C2 is a friendly clay cheese mouse as large as a bus. Duration: 15 seconds, aspect ratio 16:9. The entire sequence must be one continuous master shot with no visible cuts. A single virtual camera first bobs alongside him as he jumps, then dives into the hole with him, tilts upward from the bottom of the tunnel, follows him as he bursts out of the hole, and finally rises to an extreme long shot. All changes in shot scale must be achieved through this continuous camera movement. Visual style: Handcrafted clay stop-motion animation in the style of Aardman Animations. Preserve clearly visible fingerprints, clay textures, and slightly uneven surfaces, with the characteristic stepped motion of 12 fps stop-motion animation. Use lighting that resembles a real miniature set and macro-photography-style shallow depth of field. The cheese moon wobbles like jelly. The sky is made of black felt, decorated with tin-foil stars and a clay Earth. The overall atmosphere is warm, cozy, and whimsical. Visual concept: Hunger and courage. A little dog, an enormous fork, a wobbling cheese moon, and a new friend. Environment: A yellow cheese moon riddled with holes, underground cheese tunnels, a small crooked clay rocket, and Earth in the sky. Audio: No music for the first 12 seconds. During the final three seconds, a cheerful tuba and ukulele duet plays. Sound effects include squeaky clay footsteps, springy \"boing-whoing\" sounds during slow, low-gravity jumps, deep jelly-like rumbles as the moon shakes, a rubbery \"pop\" as the hole opens, a rushing whoosh during tumbling, loud chewing from the giant mouse and a startled squeal, frantic paw-scratching sounds, a satisfying bite as Biscuit finally gets his cheese, contented chewing, and the sound of his tail thumping against the ground. Emotional progression: L1 Curiosity → L3 Surprise → L4 Panic → L5 Chase at its peak → L5 Ecstatic bliss at the first bite of cheese → L1 Warmth and contentment. Storyboard beats (continuous throughout, no cuts): 0–2 seconds (P01): The camera stays close to the cheese surface at a low angle. Biscuit steps out of the crooked little rocket and plants one paw on the cheese. He sniffs it, and his eyes grow wider with anticipation. He carries the fork over his shoulder, and Earth is visible in the sky. 2–4.5 seconds (P02): The camera bobs alongside him with each jump. He makes slow, exaggerated low-gravity leaps across the cheese landscape, his ears bouncing and flapping upward. He plunges his fork into a large wedge of cheese, and the entire surface immediately wobbles like jelly as a gigantic hole opens beneath his feet. 4.5–7 seconds (P03): The camera dives into the hole alongside him. Still gripping his fork, Biscuit tumbles slowly through a hole-riddled cheese tunnel, passing a gigantic clay cheese mouse as large as a bus that is busy nibbling on the tunnel wall. Biscuit'\''s appearance startles the mouse. 7–9.5 seconds (P04): The camera reaches the bottom of the tunnel and tilts upward. The giant mouse turns around, its whiskers trembling, and chases Biscuit up the tunnel. Panicking, Biscuit ricochets between the tunnel walls, with curly ribbons of cheese trailing behind his fork. 9.5–12 seconds (P05): The camera follows them as they burst out of the hole. Biscuit launches upward in a slow, high arc, and the giant mouse'\''s head emerges from the opening immediately behind him. Suspended upside down in midair, Biscuit scoops up a huge curl of cheese with his fork and puts it into his mouth, instantly experiencing overwhelming bliss. 12–15 seconds (P06): The camera rises and pulls back into an extreme long shot. Biscuit and the giant mouse sit side by side on the edge of the hole, happily sharing cheese. The rocket rests behind them, Earth slowly rises in the distance, and tin-foil stars dot the sky. Biscuit exhales contentedly, fogging up his helmet glass, while his tail wags happily. The tuba and ukulele duet begins. Hold on this final composition."
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_4_moon_cheese_storyboard.png",
      "id": "Image1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_4_biscuit_character_board.png",
      "id": "Image2"
    }
  ],
  "settings": {
    "duration": 15,
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 5.Video Editing with Instructions

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-full">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-012.4f826c1b0ab893ef.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-012.fd57851a6c3718a2.715af3b1c7bdb745.webp" alt="" /></button>

<p>Video 1</p>
</div>
</div>

```text
Edit @Video1. Remove the foreground person from the video. Keep everything else unchanged.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-011.99b6dbfc80b359c9.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-011.9a4aa82cdbc622fe.d6e8e1f090c1e0af.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Edit @Video1. Remove the foreground person from the video. Keep everything else unchanged."
    },
    {
      "type": "base_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_5_guitar_foreground_source.mp4",
      "id": "Video1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 6.Video Editing with Reference Assets

#### ① Add a Subject

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-video-full">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-013.7df3eb0cdfd0eacc.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-013.6e7962a901450b9b.2c831241b7013a8f.webp" alt="" /></button>

<p>Video 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-008.32efa34f29c34fa8.5028039febf1341c.webp" alt="" /></div>

<p>Element 1 - Front</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-010.dd24b8f45d1d2109.92bcfa875a168edd.webp" alt="" /></div>

<p>Element 1 - Side</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-015.949ee5c08fb9a83c.a6dda2b04325718d.webp" alt="" /></div>

<p>Element 1 - Back</p>
</div>
</div>

```text
Edit @Video1. In the final moment when the box is opened again, @Element1 is lying inside asleep.
Change the final line "Ah, they're all old tricks, nothing new." to "Why is there a pig here?"
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-018.3bd2cccae3bf75e3.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-018.db4ade6b659f0878.c189a823544a5b2f.webp" alt="" /></button>

**API example:**

##### Step 1: Create a pig element using three-view images.

Fill frontal_image with the front-view image, and refer_images with the side-view and back-view images. This example does not bind a voice profile, callback, or tags — do not fill in optional placeholder fields that have no actual value. The creation request's response appears directly in the terminal; save the element creation task ID from it, then query the creation result.

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/v1/general/advanced-custom-elements' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "element_name": "pink_pig_case_12_6",
  "element_description": "A pink cartoon pig, created from front, side, and back views of the same pig for the sleeping-pig-in-a-box video editing example.",
  "reference_type": "image_refer",
  "element_image_list": {
    "frontal_image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_pink_pig_front_ref.png",
    "refer_images": [
      {
        "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_pink_pig_side_ref.png"
      },
      {
        "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_pink_pig_back_ref.png"
      }
    ]
  }
}'
```

**Query the element creation result and retrieve the element ID.**

Replace REPLACE_WITH_ELEMENT_CREATION_TASK_ID in the path below with the task ID returned when creating the element (not the element ID itself). You can also use a unique external_task_id to query — choose one of the two methods. This example uses the server-side task ID since no external_task_id was set.

```cURL
curl -sS --request GET \
  'https://api-singapore.klingai.com/v1/general/advanced-custom-elements/REPLACE_WITH_ELEMENT_CREATION_TASK_ID' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json'
```

Wait for the element creation to succeed, then extract the new pig element's element_id from the query response and fill it into REPLACE_WITH_PIG_ELEMENT_ID in Step 2. The element creation task ID, the element's element_id, and the video task ID are three distinct identifiers — do not confuse them. If the element is still being created or the creation has failed, do not proceed to Step 2. Do not re-create the element if the creation task has not yet returned a successful result.

##### Step 2: Edit a video using the newly created pig element.

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Edit @Video1. In the final moment when the box is opened again, @Element1 is lying inside asleep. Change the final line \"Ah, they'\''re all old tricks, nothing new.\" to \"Why is there a pig here?\""
    },
    {
      "type": "base_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_box_source.mp4",
      "id": "Video1"
    },
    {
      "type": "element",
      "element_id": "REPLACE_WITH_PIG_ELEMENT_ID",
      "id": "Element1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

#### ② Replace Characters and Scene

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-020.154d9c1e6ccfacdd.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-020.64a03f8fe590c67c.f80d85e433f0464c.webp" alt="" /></button>

<p>Video1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-023.9f1edc325ceab418.7b20b518757070b0.webp" alt="" /></div>

<p>Image1</p>
</div>
</div>

```text
Edit @Video1. Replace the environment and characters throughout with those in @Image1.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-022.565d08c4dad3a92f.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-022.729512c6adb5e11b.de7a2f2a81b0e118.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Edit @Video1. Replace the environment and characters throughout with those in @Image1."
    },
    {
      "type": "base_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_scene_swap_source.mp4",
      "id": "Video1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_red_dress_woman_ref.png",
      "id": "Image1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

#### ③ Multi-Character Replacement

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list guide-case-media-list-video-full">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-028.54c60fe5438dd3b0.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-028.e5fa59578dada32e.958eec9aa2ec8e62.webp" alt="" /></button>

<p>Video 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-019.b4219ec22489a6db.bc5fb160287eb7b7.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-021.665dabb3d4f32dfc.557174592dfc34d0.webp" alt="" /></div>

<p>Image 2</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-024.064cc339c9c720c6.332da682ba59a8e2.webp" alt="" /></div>

<p>Image 3</p>
</div>
</div>

```text
Edit @Video1. Preserve its camera, framing, duration, pacing, aspect ratio, walking paths and convenience-store setting, including the green doorframe, shelves, lighting and reflections. Replace only the three exiting people, in this order:
1. @Image1 defines the first man’s identity and outfit: dark curls, white sun hat, white short-sleeved shirt over a black-and-white striped top, green apron, loose light-gray jeans and dark sneakers. At the doorway, he slightly lifts his hat brim, then approaches the camera and exits through the foreground.
2. @Image2 defines the woman’s identity and outfit: short light-blonde hair, red sweatshirt, green apron, white knee-high socks and red shoes. At the doorway, she adjusts her apron and gives a small wave, then approaches and exits.
3. @Image3 defines the second man’s identity, outfit and prop: short light-blonde hair, white chef hat, black-framed glasses, blue-green-and-black patterned knitwear, green apron, white shoes and the same off-white plush sheep. Supporting the sheep with one arm, he adjusts his glasses with his free hand, then approaches, slightly raises the sheep and exits.
Each character’s appearance 100% matches the corresponding reference. Fit these gestures into the source clip’s existing doorway pauses and walking timing.
Fix a sign inside the right-hand glass window, centred in its clear area and unobstructed by the characters. Exact text: “KLING AI OPEN 24 hours”. Keep its lettering sharp, stable and unchanged throughout.
Everything else remains unchanged. No additional people, text, logos or watermarks.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-021.8abacc5f1cbe004e.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-021.e35633afedff7980.535a2d091b369f06.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Edit @Video1. Preserve its camera, framing, duration, pacing, aspect ratio, walking paths and convenience-store setting, including the green doorframe, shelves, lighting and reflections. Replace only the three exiting people, in this order: 1. @Image1 defines the first man’s identity and outfit: dark curls, white sun hat, white short-sleeved shirt over a black-and-white striped top, green apron, loose light-gray jeans and dark sneakers. At the doorway, he slightly lifts his hat brim, then approaches the camera and exits through the foreground. 2. @Image2 defines the woman’s identity and outfit: short light-blonde hair, red sweatshirt, green apron, white knee-high socks and red shoes. At the doorway, she adjusts her apron and gives a small wave, then approaches and exits. 3. @Image3 defines the second man’s identity, outfit and prop: short light-blonde hair, white chef hat, black-framed glasses, blue-green-and-black patterned knitwear, green apron, white shoes and the same off-white plush sheep. Supporting the sheep with one arm, he adjusts his glasses with his free hand, then approaches, slightly raises the sheep and exits. Each character’s appearance 100% matches the corresponding reference. Fit these gestures into the source clip’s existing doorway pauses and walking timing. Fix a sign inside the right-hand glass window, centred in its clear area and unobstructed by the characters. Exact text: “KLING AI OPEN 24 hours”. Keep its lettering sharp, stable and unchanged throughout. Everything else remains unchanged. No additional people, text, logos or watermarks."
    },
    {
      "type": "base_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_store_staff_source.mp4",
      "id": "Video1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_visor_staff_ref.png",
      "id": "Image1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_red_sweater_staff_ref.png",
      "id": "Image2"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_6_glasses_staff_ref.png",
      "id": "Image3"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 7.Video Style Editing

When specifying a style, a combination of positive description and negative exclusion tends to produce more stable results:

```text
Edit @Video1. Replace the video's style with the felt style from @Image1. Preserve the original video's composition, camera work, and actions — only the style changes. Do not change character outfit designs, motorcycle design, scene elements, or the order of events.
```

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-023.103cba7a7c7d725a.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-023.f7d511a744c621b1.db45e44701be270d.webp" alt="" /></button>

<p>Video 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-022.0f9f342385e77781.675545bf910361ec.webp" alt="" /></div>

<p>Image 1</p>
</div>
</div>

```text
Edit @Video1. Replace the video's style with the felt style from @Image1. Preserve the original video's composition, camera work, and actions — only the style changes. Do not change character outfit designs, motorcycle design, scene elements, or the order of events.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-026.0d4bfa5cfdf5e76e.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-026.b14d452cdc21ec11.b5c0b924d2292018.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "Edit @Video1. Replace the video'\''s style with the felt style from @Image1. Preserve the original video'\''s composition, camera work, and actions — only the style changes. Do not change character outfit designs, motorcycle design, scene elements, or the order of events."
    },
    {
      "type": "base_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_7_cyber_motorcycle_source.mov",
      "id": "Video1"
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_7_felt_picnic_style_ref.png",
      "id": "Image1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 8.Text Generation

Suitable for brand advertising, product packaging, screen interfaces, and other visuals that require accurate on-screen text.

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-020.978d3293498c6d64.d0305de9cba93139.webp" alt="" /></div>

<p>Image 1</p>
</div>
</div>

```text
SCENE CONTEXTEXACT 3 UNIQUE CHARACTERS ACROSS THE VIDEO — NO DUPLICATES.EXT. enchanted counting forest classroom, warm morning. One soft cream cloud teacher teaches the numbers 1, 2, 3 and 4 in four separate shots. Two tiny yellow chick pupils appear only in the number-two shot.3 characters across the video, 5 hard-cut shots, 15s, real time.@Image1: visual-world reference only — handmade clay-and-felt materials, rounded toy-like forms, pastel forest trunks, mossy ground, rainbow colours, warm diffused backlight and shallow storybook depth. Never inherit its existing characters, numerals or composition.LOCATION MAPAll five shots occur on the same circular moss stage inside one enchanted forest classroom.One broad warm-brown tree trunk anchors frame-left; a second tree trunk anchors frame-right. A curved pastel rainbow root crosses the background.The central teaching pedestal remains in the same position in every shot.Camera always stays on the front side of the teaching axis, between 3.0 and 3.3 m from the pedestal.The sun always comes from upper frame-right. Background geometry, material scale and colour palette remain identical after every cut.FIRST FRAME AND SPATIAL BLOCKINGShot 1: the cloud teacher floats centre-left, facing a large red felt numeral 1 on the central pedestal. One red apple is concealed inside the moss below it.Shot 2: the cloud teacher floats centre-left, facing a large amber felt numeral 2. Two yellow chicks begin concealed behind the pedestal.Shot 3: the cloud teacher floats centre-left, facing a large green felt numeral 3. Three blue felt stars begin nested inside the moss.Shot 4: the cloud teacher floats centre-left, facing a large blue felt numeral 4. Four purple clay blocks begin below the pedestal.Shot 5: the cloud teacher floats alone at centre, facing the viewer beneath the rainbow root.Every shot begins mid-gesture with the teacher already pointing toward the active numeral. No empty establishing beat.FORMAT MODEHorizontal 16:9, total 15s, real time, 5 shots connected by clean hard cuts.Shot 1 — 0.00–4.00s: number 1 and one apple.Shot 2 — 4.00–7.08s: number 2 and two chicks.Shot 3 — 7.08–10.21s: number 3 and three stars.Shot 4 — 10.21–13.08s: number 4 and four blocks.Shot 5 — 13.08–15.00s: spoken recap and celebration.Each number receives its own separate shot. Numerals 1, 2, 3 and 4 never share the same teaching frame.No fades, dissolves or split screens.OPTICS35mm equivalent, 54° horizontal FOV, locked across all five shots.Identical natural perspective, camera height, background scale and depth-of-field character after every cut.Focal plane remains on the cloud teacher, active numeral and active quantity.Foreground flowers softly obscure the lower corners. Distant trees dissolve into the same creamy storybook blur.CAMERAEvery shot is operated handheld at approximately 105 cm height from the front side of the teaching axis.World register: gentle SETTLE.Shot 1: slow 10 cm push toward numeral 1.Shot 2: slow 10 cm push toward numeral 2.Shot 3: slow 10 cm push toward numeral 3.Shot 4: slow 10 cm push toward numeral 4.Shot 5: slow 8 cm push toward the celebrating teacher.Visible handheld character throughout: breath sway, micro-roll, late tiny corrections and gentle but obvious handmade shake. Numerals and subtitles remain readable.Camera height, axis and movement speed match across all cuts.Not a gimbal, slider, tripod lock-off, drone or digitally stabilised camera.ACTION TIMING0.00–0.78s: Shot 1 begins. The cloud teacher already points toward the red numeral 1.0.78–1.98s: numeral 1 rises and completes one soft bounce.1.98–4.00s: one red apple rises from the moss and settles beneath numeral 1.4.00–4.86s: hard cut to Shot 2. The amber numeral 2 rises and completes one soft bounce.4.86–7.08s: one yellow chick hops out from the left, then a second chick joins from the right; they touch shoulders and settle together.7.08–8.04s: hard cut to Shot 3. The green numeral 3 rises and completes one soft bounce.8.04–10.21s: two blue felt stars rise together, followed by one additional star; the three stars settle into a clear triangular arrangement.10.21–11.06s: hard cut to Shot 4. The blue numeral 4 rises and completes one soft bounce.11.06–13.08s: three purple blocks assemble first; one additional block clicks into the fourth position.13.08–14.40s: hard cut to Shot 5. Four tiny coloured fireflies pulse sequentially red, amber, green and blue while the teacher points from left to right.14.40–15.00s: the teacher opens both arms; a small clay sun unfolds above the rainbow and releases a brief sparkle burst.PHYSICSThe cloud teacher has the buoyancy of a lightweight stuffed felt puppet, with soft vertical drift and delayed arm movement.Each numeral has padded felt weight: it compresses, rebounds once and settles.The apple lands with soft clay weight. The chicks’ feet squash slightly into the moss. Stars descend with gentle air resistance. Blocks connect with firm edge-to-edge contact.Every quantity remains stable and readable until its shot ends.Hard cuts reset the teaching pedestal cleanly while preserving the same forest, teacher identity, material scale and lighting.LIGHTINGOne identical motivated source in every shot: warm morning sunlight filtering through the trees from upper frame-right.The teacher’s lower-left side remains slightly darker in all five shots.Soft rim light separates the felt fibres from the forest.Protect the cream cloud, pastel numerals and rainbow highlights from clipping.The direction, colour temperature, haze density and exposure remain unchanged across every cut.AUDIOVOICEOVER: the cloud teacher speaks in English with the same warm, clear, medium-high preschool-teacher voice in every shot. Pronunciation is slow, encouraging and rhythmically precise.0.78s: “One.”1.98s: “One means just one.”4.16s: “Two.”4.86s: “Two means one and one together.”7.26s: “Three.”8.04s: “Three means two and one more.”10.32s: “Four.”11.06s: “Four means three and one more.”13.32s: “One, two, three, four.”14.40s: “Great job!”MUSIC: one continuous original children’s instrumental across all cuts, using soft marimba, toy piano, light ukulele, felt-drum taps and gentle handclaps. The same melody, tempo and instrumentation continue seamlessly through every shot. It rises slightly with each new number and ends with a short celebratory flourish.SFX: one soft felt pop for each numeral bounce; one clay plop for the apple; two tiny moss footsteps for the chicks; three sparkle chimes for the stars; four wooden clicks for the blocks; four soft firefly pings during the recap; one bright celebration chime at the end.AMBIENCE: continuous close grass rustle, mid-distance leaves and faint woodland birds. The ambience never resets at the cuts.MIX: narration remains clear and centred. Music ducks beneath every spoken line. Sound effects synchronise exactly with the quantities. Music and ambience remain continuous across every hard cut.SUBTITLESBurned-in English subtitles, bottom-centre inside the title-safe area, positioned 10% above the lower edge.One or two lines maximum. Rounded cream felt subtitle panel with dark chocolate-brown bold lettering, high contrast and stable placement.Subtitles appear and disappear exactly with the matching narration:0.78–1.38s: “ONE.”1.98–3.84s: “ONE MEANS JUST ONE.”4.16–4.66s: “TWO.”4.86–6.82s: “TWO MEANS ONE AND ONE TOGETHER.”7.26–7.78s: “THREE.”8.04–10.16s: “THREE MEANS TWO AND ONE MORE.”10.32–10.80s: “FOUR.”11.06–13.08s: “FOUR MEANS THREE AND ONE MORE.”13.32–14.24s: “ONE, TWO, THREE, FOUR.”14.40–15.00s: “GREAT JOB!”CHARACTER ACTINGCloud teacher: identical body proportions, cream felt texture, tiny arms, dot eyes, rosy cheeks and small smiling mouth in every shot. Uses slow preschool-teaching gestures. The gaze always lands on the active numeral or quantity. The expression gradually changes from patient concentration in Shot 1 to a broad celebratory smile in Shot 5.Shot 1: points with one hand and watches the single apple settle.Shot 2: brings both hands together as the two chicks join.Shot 3: traces a small triangle after the third star appears.Shot 4: raises four soft fingertips after the final block connects.Shot 5: points across four firefly pulses, then opens both arms toward the viewer.Two chick pupils: appear only in Shot 2. The first chick leaves a visible space beside itself; the second fills that space. Both look up at the teacher and blink once after joining.STYLEOne perfectly consistent handmade clay-and-felt stop-motion storybook world across every shot.Rounded silhouettes, tactile fingerprints, plush fibres, softly imperfect surfaces, oversized friendly trees, moss carpet, tiny flowers and pastel rainbow details.Identical teacher model, forest geometry, prop scale, material softness, lens character and lighting direction after every cut.Soft vintage optical character, old-photograph texture, subtle film grain, slight halation and natural motion blur.Colour 60:30:10 = moss green and warm wood / cream and pastel numeral colours / coral-red and sunny-yellow accents.旧照片质感模糊不要锐化.QUALITYThe cloud teacher, active numeral, active quantity and subtitles remain readable in every shot.Numeral shapes are conventional, upright and unambiguous.Subtitle spelling, punctuation and timing match the specified script exactly.Subtitle size, typeface, panel shape and screen position remain identical across all cuts.Soft old-photo resolution, never digitally sharpened.Natural motion blur without ghosting, duplicated limbs, malformed numerals, incorrect quantities or plastic CGI surfaces.POSITIVE CONSTRAINTSNumbers 1, 2, 3 and 4 each receive one separate teaching shot.Only one large numeral appears in each teaching shot.Shot 1 contains exactly one apple.Shot 2 contains exactly two yellow chicks.Shot 3 contains exactly three blue stars.Shot 4 contains exactly four purple blocks.Shot 5 contains only the cloud teacher, four sequential firefly pulses and the final clay sun.The same cloud teacher identity, forest style, light direction, optics, colour palette, music and subtitle design continue across every cut.Speech count: exactly 10 lines.Every subtitle matches its spoken line word for word.A shared 1–4 teaching frame, split screen, incorrect quantity, extra character, style change, lighting change, malformed subtitle or mismatched narration = failed shot.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-027.b645818803078c1e.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-027.cebc8790d23ada91.596a1662a090a655.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "SCENE CONTEXTEXACT 3 UNIQUE CHARACTERS ACROSS THE VIDEO — NO DUPLICATES.EXT. enchanted counting forest classroom, warm morning. One soft cream cloud teacher teaches the numbers 1, 2, 3 and 4 in four separate shots. Two tiny yellow chick pupils appear only in the number-two shot.3 characters across the video, 5 hard-cut shots, 15s, real time.@Image1: visual-world reference only — handmade clay-and-felt materials, rounded toy-like forms, pastel forest trunks, mossy ground, rainbow colours, warm diffused backlight and shallow storybook depth. Never inherit its existing characters, numerals or composition.LOCATION MAPAll five shots occur on the same circular moss stage inside one enchanted forest classroom.One broad warm-brown tree trunk anchors frame-left; a second tree trunk anchors frame-right. A curved pastel rainbow root crosses the background.The central teaching pedestal remains in the same position in every shot.Camera always stays on the front side of the teaching axis, between 3.0 and 3.3 m from the pedestal.The sun always comes from upper frame-right. Background geometry, material scale and colour palette remain identical after every cut.FIRST FRAME AND SPATIAL BLOCKINGShot 1: the cloud teacher floats centre-left, facing a large red felt numeral 1 on the central pedestal. One red apple is concealed inside the moss below it.Shot 2: the cloud teacher floats centre-left, facing a large amber felt numeral 2. Two yellow chicks begin concealed behind the pedestal.Shot 3: the cloud teacher floats centre-left, facing a large green felt numeral 3. Three blue felt stars begin nested inside the moss.Shot 4: the cloud teacher floats centre-left, facing a large blue felt numeral 4. Four purple clay blocks begin below the pedestal.Shot 5: the cloud teacher floats alone at centre, facing the viewer beneath the rainbow root.Every shot begins mid-gesture with the teacher already pointing toward the active numeral. No empty establishing beat.FORMAT MODEHorizontal 16:9, total 15s, real time, 5 shots connected by clean hard cuts.Shot 1 — 0.00–4.00s: number 1 and one apple.Shot 2 — 4.00–7.08s: number 2 and two chicks.Shot 3 — 7.08–10.21s: number 3 and three stars.Shot 4 — 10.21–13.08s: number 4 and four blocks.Shot 5 — 13.08–15.00s: spoken recap and celebration.Each number receives its own separate shot. Numerals 1, 2, 3 and 4 never share the same teaching frame.No fades, dissolves or split screens.OPTICS35mm equivalent, 54° horizontal FOV, locked across all five shots.Identical natural perspective, camera height, background scale and depth-of-field character after every cut.Focal plane remains on the cloud teacher, active numeral and active quantity.Foreground flowers softly obscure the lower corners. Distant trees dissolve into the same creamy storybook blur.CAMERAEvery shot is operated handheld at approximately 105 cm height from the front side of the teaching axis.World register: gentle SETTLE.Shot 1: slow 10 cm push toward numeral 1.Shot 2: slow 10 cm push toward numeral 2.Shot 3: slow 10 cm push toward numeral 3.Shot 4: slow 10 cm push toward numeral 4.Shot 5: slow 8 cm push toward the celebrating teacher.Visible handheld character throughout: breath sway, micro-roll, late tiny corrections and gentle but obvious handmade shake. Numerals and subtitles remain readable.Camera height, axis and movement speed match across all cuts.Not a gimbal, slider, tripod lock-off, drone or digitally stabilised camera.ACTION TIMING0.00–0.78s: Shot 1 begins. The cloud teacher already points toward the red numeral 1.0.78–1.98s: numeral 1 rises and completes one soft bounce.1.98–4.00s: one red apple rises from the moss and settles beneath numeral 1.4.00–4.86s: hard cut to Shot 2. The amber numeral 2 rises and completes one soft bounce.4.86–7.08s: one yellow chick hops out from the left, then a second chick joins from the right; they touch shoulders and settle together.7.08–8.04s: hard cut to Shot 3. The green numeral 3 rises and completes one soft bounce.8.04–10.21s: two blue felt stars rise together, followed by one additional star; the three stars settle into a clear triangular arrangement.10.21–11.06s: hard cut to Shot 4. The blue numeral 4 rises and completes one soft bounce.11.06–13.08s: three purple blocks assemble first; one additional block clicks into the fourth position.13.08–14.40s: hard cut to Shot 5. Four tiny coloured fireflies pulse sequentially red, amber, green and blue while the teacher points from left to right.14.40–15.00s: the teacher opens both arms; a small clay sun unfolds above the rainbow and releases a brief sparkle burst.PHYSICSThe cloud teacher has the buoyancy of a lightweight stuffed felt puppet, with soft vertical drift and delayed arm movement.Each numeral has padded felt weight: it compresses, rebounds once and settles.The apple lands with soft clay weight. The chicks’ feet squash slightly into the moss. Stars descend with gentle air resistance. Blocks connect with firm edge-to-edge contact.Every quantity remains stable and readable until its shot ends.Hard cuts reset the teaching pedestal cleanly while preserving the same forest, teacher identity, material scale and lighting.LIGHTINGOne identical motivated source in every shot: warm morning sunlight filtering through the trees from upper frame-right.The teacher’s lower-left side remains slightly darker in all five shots.Soft rim light separates the felt fibres from the forest.Protect the cream cloud, pastel numerals and rainbow highlights from clipping.The direction, colour temperature, haze density and exposure remain unchanged across every cut.AUDIOVOICEOVER: the cloud teacher speaks in English with the same warm, clear, medium-high preschool-teacher voice in every shot. Pronunciation is slow, encouraging and rhythmically precise.0.78s: “One.”1.98s: “One means just one.”4.16s: “Two.”4.86s: “Two means one and one together.”7.26s: “Three.”8.04s: “Three means two and one more.”10.32s: “Four.”11.06s: “Four means three and one more.”13.32s: “One, two, three, four.”14.40s: “Great job!”MUSIC: one continuous original children’s instrumental across all cuts, using soft marimba, toy piano, light ukulele, felt-drum taps and gentle handclaps. The same melody, tempo and instrumentation continue seamlessly through every shot. It rises slightly with each new number and ends with a short celebratory flourish.SFX: one soft felt pop for each numeral bounce; one clay plop for the apple; two tiny moss footsteps for the chicks; three sparkle chimes for the stars; four wooden clicks for the blocks; four soft firefly pings during the recap; one bright celebration chime at the end.AMBIENCE: continuous close grass rustle, mid-distance leaves and faint woodland birds. The ambience never resets at the cuts.MIX: narration remains clear and centred. Music ducks beneath every spoken line. Sound effects synchronise exactly with the quantities. Music and ambience remain continuous across every hard cut.SUBTITLESBurned-in English subtitles, bottom-centre inside the title-safe area, positioned 10% above the lower edge.One or two lines maximum. Rounded cream felt subtitle panel with dark chocolate-brown bold lettering, high contrast and stable placement.Subtitles appear and disappear exactly with the matching narration:0.78–1.38s: “ONE.”1.98–3.84s: “ONE MEANS JUST ONE.”4.16–4.66s: “TWO.”4.86–6.82s: “TWO MEANS ONE AND ONE TOGETHER.”7.26–7.78s: “THREE.”8.04–10.16s: “THREE MEANS TWO AND ONE MORE.”10.32–10.80s: “FOUR.”11.06–13.08s: “FOUR MEANS THREE AND ONE MORE.”13.32–14.24s: “ONE, TWO, THREE, FOUR.”14.40–15.00s: “GREAT JOB!”CHARACTER ACTINGCloud teacher: identical body proportions, cream felt texture, tiny arms, dot eyes, rosy cheeks and small smiling mouth in every shot. Uses slow preschool-teaching gestures. The gaze always lands on the active numeral or quantity. The expression gradually changes from patient concentration in Shot 1 to a broad celebratory smile in Shot 5.Shot 1: points with one hand and watches the single apple settle.Shot 2: brings both hands together as the two chicks join.Shot 3: traces a small triangle after the third star appears.Shot 4: raises four soft fingertips after the final block connects.Shot 5: points across four firefly pulses, then opens both arms toward the viewer.Two chick pupils: appear only in Shot 2. The first chick leaves a visible space beside itself; the second fills that space. Both look up at the teacher and blink once after joining.STYLEOne perfectly consistent handmade clay-and-felt stop-motion storybook world across every shot.Rounded silhouettes, tactile fingerprints, plush fibres, softly imperfect surfaces, oversized friendly trees, moss carpet, tiny flowers and pastel rainbow details.Identical teacher model, forest geometry, prop scale, material softness, lens character and lighting direction after every cut.Soft vintage optical character, old-photograph texture, subtle film grain, slight halation and natural motion blur.Colour 60:30:10 = moss green and warm wood / cream and pastel numeral colours / coral-red and sunny-yellow accents.旧照片质感模糊不要锐化.QUALITYThe cloud teacher, active numeral, active quantity and subtitles remain readable in every shot.Numeral shapes are conventional, upright and unambiguous.Subtitle spelling, punctuation and timing match the specified script exactly.Subtitle size, typeface, panel shape and screen position remain identical across all cuts.Soft old-photo resolution, never digitally sharpened.Natural motion blur without ghosting, duplicated limbs, malformed numerals, incorrect quantities or plastic CGI surfaces.POSITIVE CONSTRAINTSNumbers 1, 2, 3 and 4 each receive one separate teaching shot.Only one large numeral appears in each teaching shot.Shot 1 contains exactly one apple.Shot 2 contains exactly two yellow chicks.Shot 3 contains exactly three blue stars.Shot 4 contains exactly four purple blocks.Shot 5 contains only the cloud teacher, four sequential firefly pulses and the final clay sun.The same cloud teacher identity, forest style, light direction, optics, colour palette, music and subtitle design continue across every cut.Speech count: exactly 10 lines.Every subtitle matches its spoken line word for word.A shared 1–4 teaching frame, split screen, incorrect quantity, extra character, style change, lighting change, malformed subtitle or mismatched narration = failed shot."
    },
    {
      "type": "refer_image",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_8_counting_forest_style_ref.png",
      "id": "Image1"
    }
  ],
  "settings": {
    "duration": 15,
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

## 9.Keyframes

#### ① First Frame

**Pattern:** @Image1 as the first frame, [what happens next]

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-018.22f8d233ae2ccbd1.84647bb36dffe77b.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-024.5afe01d881b8e093.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-024.16a28d2c9ebc6bb6.9697d4c055ba59bc.webp" alt="" /></button>

<p>Video 1</p>
</div>
</div>

```text
@图片1 is the first frame.  @视频1 is the reference for camera, motion, timing and cuts. Recreate  @视频1  shot-for-shot and cut-for-cut, but starting from @图片1 : the rider is SITTING in a black office swivel chair instead of standing on a bike. Same chest-mounted GoPro fisheye POV, same ramp, canyon, river, orange parachute with white ring, airboat and cheering crew, same three jump-cuts and audio as @视频1 . Wherever  @视频1 shows the bike — under the rider on the ramp, shoved away at the cliff, tumbling below in free-fall, and the tiny silhouette during the parachute opening — show the office chair (mesh backrest, padded seat, chrome column, five-spoke base, casters). Before the launch the rider stays seated exactly as in  @图片1 : thighs and knees at the bottom of frame, sneakers on the star base, hands on the armrests. No bicycle, handlebar, tyres or pedals anywhere.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-025.a9b3fe20a30d81eb.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-025.45a70b577a7c8e86.dcdd146000a1a9e7.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/omni-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "@Image1 is the first frame.  @Video1 is the reference for camera, motion, timing and cuts. Recreate  @Video1  shot-for-shot and cut-for-cut, but starting from @Image1 : the rider is SITTING in a black office swivel chair instead of standing on a bike. Same chest-mounted GoPro fisheye POV, same ramp, canyon, river, orange parachute with white ring, airboat and cheering crew, same three jump-cuts and audio as @Video1 . Wherever  @Video1 shows the bike — under the rider on the ramp, shoved away at the cliff, tumbling below in free-fall, and the tiny silhouette during the parachute opening — show the office chair (mesh backrest, padded seat, chrome column, five-spoke base, casters). Before the launch the rider stays seated exactly as in  @Image1 : thighs and knees at the bottom of frame, sneakers on the star base, hands on the armrests. No bicycle, handlebar, tyres or pedals anywhere."
    },
    {
      "type": "first_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_canyon_chair_first_frame.png",
      "id": "Image1"
    },
    {
      "type": "feature_video",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_canyon_jump_source.mp4",
      "id": "Video1"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}'
```

#### ② First Frame and Last Frame

**Pattern:** @Image1 as the first frame, @Image2 as the last frame, generate [the process in between]

**Applicable scenarios:** Transformation process showcases, craft demonstrations, before-and-after comparisons.

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-027.28ce7e516ccab32c.1d9ada16fc453e7f.webp" alt="" /></div>

<p>First Frame</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-033.77ca9a04f21afed5.9f0a296a09536296.webp" alt="" /></div>

<p>Last Frame</p>
</div>
</div>

```text
SCENE CONTEXTEXACT 1 CHARACTER — NO DUPLICATES.Interior, a worn blacksmith workshop, daytime.The same blacksmith removes the raw material, works it into a greatsword, and returns the completed sword to the original table.15 seconds, six shots. Manufacturing time is compressed through editorial cuts; individual actions retain natural weight and speed.ACTIVE REFERENCES@Image1: exact first-frame anchor. Preserve all five iron blocks, their arrangement, the tabletop, background tools, perspective, and lighting. This image is the starting state of an active pickup shot.@Image2: exact final-frame anchor and finished-sword design. Preserve the blade silhouette, central fuller, angular curved crossguard, spiral metal grip, faceted pommel, diagonal placement, perspective, and background. This composition is reached through a visible physical placement.LOCATION MAPThe worktable fills the foreground. The tool bucket stands behind its left-center edge, the rod rack occupies the rear right, and the anvil stands at the right.The blacksmith works from the left side of the table in both endpoint shots.The camera stays on the original viewer-facing side of the table.During blade-working inserts, the tang points screen-left and the tip points screen-right.The final sword position runs from the upper-left pommel to the lower-right tip.FIRST FRAME AND SPATIAL BLOCKINGAt 0.0 seconds, the frame exactly matches the raw-material reference, with five iron blocks and no hands visible.The same blacksmith immediately reaches in from the left edge.Both gloved hands approach the largest central block from opposite ends, preparing a supported two-handed lift.The blacksmith wears soot-gray sleeves, brown leather gloves, and a narrow dark strap around the right cuff. These details remain identical throughout every shot.FORMAT MODE15 seconds total, six shots.Hard cuts at 3.0, 5.0, 8.0, 10.0, and 11.0 seconds.Cuts compress the omitted manufacturing work and bench clearing.The opening pickup and closing placement each play as continuous physical actions.No fades, dissolves, or object-morph transitions.OPTICSShots 1 and 6: reference-matched elevated three-quarter framing, approximately 63° diagonal field of view and approximately 1.8 meters from the tabletop center.Exact endpoint framing takes priority over estimated optical measurements.Shots 2–5: 40° diagonal field of view, approximately 0.8 meters from the working contact point.Focus follows the hands and metal contact; the workshop background remains softly readable.Each shot holds one fixed field of view.CAMERAA real camera operator holds the camera from the viewer-facing side of the workspace.All shots use handheld SETTLE: visible breathing sway, slight roll, and small delayed corrections.The opening camera holds its position while the iron block leaves the frame.The closing camera holds the empty tabletop composition while the sword enters, then settles into the exact final reference.The blacksmith is the only visible worker; the camera operator remains outside the image.ACTION TIMING0.0–3.0s — TAKE THE IRON.Start on the exact first reference; during 0.0–0.6s, the blacksmith’s matching gloved hands enter from screen-left and grip opposite ends of the largest central block.During 0.6–1.5s, the wrists brace and both hands lift the block clear of the tabletop, exposing the patch of table beneath it.During 1.5–3.0s, the blacksmith carries the supported block out through screen-left; the other four blocks remain resting on the table through the cut.3.0–5.0s — HEAT THE STOCK.Hard cut forward in time to one thick billet already glowing orange among forge coals.The same gray sleeves, brown gloves, and right-cuff strap appear at screen-left as the blacksmith holds long tongs around the billet.A short controlled pull draws the billet toward the forge mouth, with heat shimmer rising above its scaled surface.5.0–8.0s — FORGE THE BLADE.Hard cut forward to an elongated orange-hot blade blank supported on the anvil, tang left and emerging tip right.The same blacksmith braces the tang with left-hand tongs and delivers three deliberate right-hand hammer strikes along the blade flat.Each strike produces local compression, wrist recoil, and a brief scatter of dark scale.8.0–10.0s — FINISH THE METAL.Hard cut forward to a cooled blade with its fuller already formed, held by the same gloved hands against an abrasive wheel.The blacksmith makes one controlled finishing pass along the bevel.A narrow stream of sparks falls from the actual contact point as a brighter strip of metal appears.10.0–11.0s — COMPLETE THE HILT.Hard cut forward to the nearly finished sword supported on a separate assembly bench, its crossguard and spiral metal grip already fitted.The same blacksmith’s left hand braces the grip while the right hand gives the faceted pommel its final tightening turn.The completed sword now has the exact construction and finish required for the final image.11.0–15.0s — PLACE THE FINISHED SWORD.Hard cut to the original worktable, now completely clear; show its empty surface for 0.4 seconds before the same gloved hands carry the completed sword in from screen-left, one hand around the grip and the other supporting the blade flat near its balance point.From 11.4–13.8s, the blacksmith lowers the entire rigid sword diagonally, hilt toward upper-left and tip toward lower-right, easing it onto the tabletop and sliding the supporting hand free as its weight transfers to the table.From 13.8–15.0s, both hands release and withdraw through screen-left; the sword remains motionless in the exact final-reference position as the camera settles onto the final frame.PHYSICSThe raw block retains its shape and mass throughout the pickup.Both hands support it continuously; the forearms tense and the lift accelerates slowly under its weight.The anvil supports the hot blade during forging. Large changes of shape occur across editorial time jumps.The completed sword remains rigid during carrying and placement.The blade-supporting hand has visible clearance to slide free as the sword settles; the hand never passes through the blade or tabletop.Metal contact produces a short scrape and a low, heavy clink, followed by stillness.The same blacksmith clears the remaining raw stock during omitted time before the final shot.LIGHTINGThe original table shots use soft daylight from upper camera-left, matching both references.Retain dark detail in the iron and protect the silver blade highlights.The forge insert uses orange coal glow from below-left as its dominant source.Return to the original neutral daylight before the sword enters the final tabletop shot.AUDIOQuiet workshop air and distant furnace draft form the ambient bed.Opening: leather creaks, a brief iron scrape, and a restrained exertion breath as the heavy block rises.Middle: forge crackle, tong contact, three synchronized hammer impacts, abrasive scraping, and a short fitting sound.Ending: sleeve movement, glove friction against metal, a weighted sword-to-table clink, then quiet workshop ambience.The blacksmith speaks no dialogue.SFX only, no music, no score, no song, no soundtrack.CHARACTER ACTINGOne consistent blacksmith performs every visible action.Soot-gray sleeves, brown leather gloves, and the dark right-cuff strap remain unchanged.Hands work deliberately: brace before lifting, maintain firm tool contact, and reduce speed before lowering the finished sword.The physical rhythm shifts from effort during the raw-block pickup to careful control during the final placement.The face and torso remain outside the crop.STYLEGrounded workshop documentary with tactile iron, worn tools, and convincing manual labor.Soft old-photograph texture, restrained grain, and natural motion blur; no digital sharpening.Charcoal metal and muted brown surfaces dominate, with silver highlights and localized forge orange.The first and last frames preserve the supplied images’ appearance.QUALITYMaintain consistent hands, gloves, sleeve details, metal geometry, and contact shadows.The lifted block reveals the tabletop underneath it.The closing shot visibly establishes the empty tabletop before the sword enters.Keep the full final sword readable, including its tip, guard, grip, and pommel.Avoid duplicate limbs, flickering geometry, and intersecting solid surfaces.POSITIVE CONSTRAINTSThe first frame contains exactly five iron blocks.The largest central block physically leaves the table in the same blacksmith’s two hands.The final shot begins with an empty table.The completed sword enters while visibly supported by that same blacksmith, contacts the tabletop, and remains after both hands withdraw.The last frame matches the finished-sword reference exactly.The opening pickup and final placement each remain continuous, with visible hand-object contact.Exactly one finished sword is present.No text overlays, subtitles, or music.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-030.201c1dd1ecdf605d.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-030.e430c83637a2bb66.b44ddebaa00c5fef.webp" alt="" /></button>

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-026.93fb6135a7799cac.a4bf54219adfc0e4.webp" alt="" /></div>

<p>First Frame</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-035.e4ca794832022c06.76fcd4c51cda01ed.webp" alt="" /></div>

<p>Last Frame</p>
</div>
</div>

```text
30s, horizontal 16:9, realistic cinematic street escape. One uninterrupted lateral tracking shot. The camera travels left along the curb, looking across the sidewalk from a consistent side angle. It accelerates and slows naturally without cuts, angle changes or playback-speed effects.
A woman runs right to left through a busy Manhattan-style street, carrying a heavy, overstuffed travel bag. Keep her identity, clothing and bag consistent. The bag lags behind her movement, strikes her thigh and pulls her carrying shoulder downward. Footfalls show traction and weight. No pursuers appear.
0–5s — CALM
Drift left past outdoor café tables as a customer lifts a coffee cup. Traffic and pedestrians move normally. The woman enters at the far right, initially blurred.
5–12s — FOLLOW
Accelerate to match her run. Pull focus onto her face with a small correction. She gasps and glances back twice while passing café seating and steaming pavement grates. Her loaded arm stays low; the bag disrupts her stride.
12–15s — LOSE HER
A yellow taxi passes between camera and sidewalk, fully obscuring her for 0.5–1s. Continue the same take behind it. She gains distance toward frame-left while the camera slows and focus drifts onto nearer street objects.
15–21s — REACQUIRE
Accelerate left and find her farther ahead through pedestrians. Refocus on her side profile. Her strides shorten; she briefly steadies the bag handle with her free hand, then continues.
21–30s — DISAPPEAR
Track her full body past scaffolding, with poles and green netting crossing the foreground. She angles slightly away into a crowded pedestrian entrance. The camera continues left but falls behind. Bodies progressively hide her until the last glimpse of her back and bag disappears. End on the moving crowd.
Cool, subdued colour, soft highlights, fine grain and shallow depth of field. Subtle shoulder-rig sway and believable acceleration; faces and bodies remain coherent through occlusions.
AUDIO
Street traffic, indistinct chatter, horns and footsteps. Her breathing and bag impacts grow louder when close, recede during separation and vanish into the crowd. No intelligible dialogue, voice-over, music, text or overlays.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-031.6ced7a84e92f057b.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-031.d5cac570473a2e44.78f5d4eaef04167b.webp" alt="" /></button>

**First and last frames — Blacksmith**

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/image-to-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "SCENE CONTEXTEXACT 1 CHARACTER — NO DUPLICATES.Interior, a worn blacksmith workshop, daytime.The same blacksmith removes the raw material, works it into a greatsword, and returns the completed sword to the original table.15 seconds, six shots. Manufacturing time is compressed through editorial cuts; individual actions retain natural weight and speed.ACTIVE REFERENCES@Image1: exact first-frame anchor. Preserve all five iron blocks, their arrangement, the tabletop, background tools, perspective, and lighting. This image is the starting state of an active pickup shot.@Image2: exact final-frame anchor and finished-sword design. Preserve the blade silhouette, central fuller, angular curved crossguard, spiral metal grip, faceted pommel, diagonal placement, perspective, and background. This composition is reached through a visible physical placement.LOCATION MAPThe worktable fills the foreground. The tool bucket stands behind its left-center edge, the rod rack occupies the rear right, and the anvil stands at the right.The blacksmith works from the left side of the table in both endpoint shots.The camera stays on the original viewer-facing side of the table.During blade-working inserts, the tang points screen-left and the tip points screen-right.The final sword position runs from the upper-left pommel to the lower-right tip.FIRST FRAME AND SPATIAL BLOCKINGAt 0.0 seconds, the frame exactly matches the raw-material reference, with five iron blocks and no hands visible.The same blacksmith immediately reaches in from the left edge.Both gloved hands approach the largest central block from opposite ends, preparing a supported two-handed lift.The blacksmith wears soot-gray sleeves, brown leather gloves, and a narrow dark strap around the right cuff. These details remain identical throughout every shot.FORMAT MODE15 seconds total, six shots.Hard cuts at 3.0, 5.0, 8.0, 10.0, and 11.0 seconds.Cuts compress the omitted manufacturing work and bench clearing.The opening pickup and closing placement each play as continuous physical actions.No fades, dissolves, or object-morph transitions.OPTICSShots 1 and 6: reference-matched elevated three-quarter framing, approximately 63° diagonal field of view and approximately 1.8 meters from the tabletop center.Exact endpoint framing takes priority over estimated optical measurements.Shots 2–5: 40° diagonal field of view, approximately 0.8 meters from the working contact point.Focus follows the hands and metal contact; the workshop background remains softly readable.Each shot holds one fixed field of view.CAMERAA real camera operator holds the camera from the viewer-facing side of the workspace.All shots use handheld SETTLE: visible breathing sway, slight roll, and small delayed corrections.The opening camera holds its position while the iron block leaves the frame.The closing camera holds the empty tabletop composition while the sword enters, then settles into the exact final reference.The blacksmith is the only visible worker; the camera operator remains outside the image.ACTION TIMING0.0–3.0s — TAKE THE IRON.Start on the exact first reference; during 0.0–0.6s, the blacksmith’s matching gloved hands enter from screen-left and grip opposite ends of the largest central block.During 0.6–1.5s, the wrists brace and both hands lift the block clear of the tabletop, exposing the patch of table beneath it.During 1.5–3.0s, the blacksmith carries the supported block out through screen-left; the other four blocks remain resting on the table through the cut.3.0–5.0s — HEAT THE STOCK.Hard cut forward in time to one thick billet already glowing orange among forge coals.The same gray sleeves, brown gloves, and right-cuff strap appear at screen-left as the blacksmith holds long tongs around the billet.A short controlled pull draws the billet toward the forge mouth, with heat shimmer rising above its scaled surface.5.0–8.0s — FORGE THE BLADE.Hard cut forward to an elongated orange-hot blade blank supported on the anvil, tang left and emerging tip right.The same blacksmith braces the tang with left-hand tongs and delivers three deliberate right-hand hammer strikes along the blade flat.Each strike produces local compression, wrist recoil, and a brief scatter of dark scale.8.0–10.0s — FINISH THE METAL.Hard cut forward to a cooled blade with its fuller already formed, held by the same gloved hands against an abrasive wheel.The blacksmith makes one controlled finishing pass along the bevel.A narrow stream of sparks falls from the actual contact point as a brighter strip of metal appears.10.0–11.0s — COMPLETE THE HILT.Hard cut forward to the nearly finished sword supported on a separate assembly bench, its crossguard and spiral metal grip already fitted.The same blacksmith’s left hand braces the grip while the right hand gives the faceted pommel its final tightening turn.The completed sword now has the exact construction and finish required for the final image.11.0–15.0s — PLACE THE FINISHED SWORD.Hard cut to the original worktable, now completely clear; show its empty surface for 0.4 seconds before the same gloved hands carry the completed sword in from screen-left, one hand around the grip and the other supporting the blade flat near its balance point.From 11.4–13.8s, the blacksmith lowers the entire rigid sword diagonally, hilt toward upper-left and tip toward lower-right, easing it onto the tabletop and sliding the supporting hand free as its weight transfers to the table.From 13.8–15.0s, both hands release and withdraw through screen-left; the sword remains motionless in the exact final-reference position as the camera settles onto the final frame.PHYSICSThe raw block retains its shape and mass throughout the pickup.Both hands support it continuously; the forearms tense and the lift accelerates slowly under its weight.The anvil supports the hot blade during forging. Large changes of shape occur across editorial time jumps.The completed sword remains rigid during carrying and placement.The blade-supporting hand has visible clearance to slide free as the sword settles; the hand never passes through the blade or tabletop.Metal contact produces a short scrape and a low, heavy clink, followed by stillness.The same blacksmith clears the remaining raw stock during omitted time before the final shot.LIGHTINGThe original table shots use soft daylight from upper camera-left, matching both references.Retain dark detail in the iron and protect the silver blade highlights.The forge insert uses orange coal glow from below-left as its dominant source.Return to the original neutral daylight before the sword enters the final tabletop shot.AUDIOQuiet workshop air and distant furnace draft form the ambient bed.Opening: leather creaks, a brief iron scrape, and a restrained exertion breath as the heavy block rises.Middle: forge crackle, tong contact, three synchronized hammer impacts, abrasive scraping, and a short fitting sound.Ending: sleeve movement, glove friction against metal, a weighted sword-to-table clink, then quiet workshop ambience.The blacksmith speaks no dialogue.SFX only, no music, no score, no song, no soundtrack.CHARACTER ACTINGOne consistent blacksmith performs every visible action.Soot-gray sleeves, brown leather gloves, and the dark right-cuff strap remain unchanged.Hands work deliberately: brace before lifting, maintain firm tool contact, and reduce speed before lowering the finished sword.The physical rhythm shifts from effort during the raw-block pickup to careful control during the final placement.The face and torso remain outside the crop.STYLEGrounded workshop documentary with tactile iron, worn tools, and convincing manual labor.Soft old-photograph texture, restrained grain, and natural motion blur; no digital sharpening.Charcoal metal and muted brown surfaces dominate, with silver highlights and localized forge orange.The first and last frames preserve the supplied images’ appearance.QUALITYMaintain consistent hands, gloves, sleeve details, metal geometry, and contact shadows.The lifted block reveals the tabletop underneath it.The closing shot visibly establishes the empty tabletop before the sword enters.Keep the full final sword readable, including its tip, guard, grip, and pommel.Avoid duplicate limbs, flickering geometry, and intersecting solid surfaces.POSITIVE CONSTRAINTSThe first frame contains exactly five iron blocks.The largest central block physically leaves the table in the same blacksmith’s two hands.The final shot begins with an empty table.The completed sword enters while visibly supported by that same blacksmith, contacts the tabletop, and remains after both hands withdraw.The last frame matches the finished-sword reference exactly.The opening pickup and final placement each remain continuous, with visible hand-object contact.Exactly one finished sword is present.No text overlays, subtitles, or music."
    },
    {
      "type": "first_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_iron_blocks_first_frame.png",
      "id": "Image1"
    },
    {
      "type": "last_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_greatsword_last_frame.png",
      "id": "Image2"
    }
  ],
  "settings": {
    "duration": 15,
    "resolution": "1080p"
  }
}'
```

**First and last frames — Street escape**

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/image-to-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "30s, horizontal 16:9, realistic cinematic street escape. One uninterrupted lateral tracking shot. The camera travels left along the curb, looking across the sidewalk from a consistent side angle. It accelerates and slows naturally without cuts, angle changes or playback-speed effects. A woman runs right to left through a busy Manhattan-style street, carrying a heavy, overstuffed travel bag. Keep her identity, clothing and bag consistent. The bag lags behind her movement, strikes her thigh and pulls her carrying shoulder downward. Footfalls show traction and weight. No pursuers appear. 0–5s — CALM Drift left past outdoor café tables as a customer lifts a coffee cup. Traffic and pedestrians move normally. The woman enters at the far right, initially blurred. 5–12s — FOLLOW Accelerate to match her run. Pull focus onto her face with a small correction. She gasps and glances back twice while passing café seating and steaming pavement grates. Her loaded arm stays low; the bag disrupts her stride. 12–15s — LOSE HER A yellow taxi passes between camera and sidewalk, fully obscuring her for 0.5–1s. Continue the same take behind it. She gains distance toward frame-left while the camera slows and focus drifts onto nearer street objects. 15–21s — REACQUIRE Accelerate left and find her farther ahead through pedestrians. Refocus on her side profile. Her strides shorten; she briefly steadies the bag handle with her free hand, then continues. 21–30s — DISAPPEAR Track her full body past scaffolding, with poles and green netting crossing the foreground. She angles slightly away into a crowded pedestrian entrance. The camera continues left but falls behind. Bodies progressively hide her until the last glimpse of her back and bag disappears. End on the moving crowd. Cool, subdued colour, soft highlights, fine grain and shallow depth of field. Subtle shoulder-rig sway and believable acceleration; faces and bodies remain coherent through occlusions. AUDIO Street traffic, indistinct chatter, horns and footsteps. Her breathing and bag impacts grow louder when close, recede during separation and vanish into the crowd. No intelligible dialogue, voice-over, music, text or overlays."
    },
    {
      "type": "first_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_cafe_street_first_frame.png",
      "id": "start"
    },
    {
      "type": "last_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_street_crowd_last_frame.png",
      "id": "end"
    }
  ],
  "settings": {
    "resolution": "1080p"
  }
}'
```

#### ③ Last Frame

**Pattern:** @Image1 as the last frame, [what happens before]

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-034.b2f314f2702b8278.09ad274c1b201c6d.webp" alt="" /></div>

<p>Image 1</p>
</div>
</div>

```text
15s, one continuous shot. Recreate the figures and setting of @Image1 as photorealistic live action, then transform them into that exact painting.
0–3s: Low tracking view of militia boots crossing stone beneath a dark archway. Move backward through a clear gap and tilt upward.
3–8s: Reveal the black-clad captain with red sash extending his hand, the pale-gold lieutenant stepping beside him, and the reference figures adjusting formation.
8–12s: Pull back and rise slightly. Everyone settles into the exact reference composition. At 11.5s, figures and drums stop; the scene remains photorealistic.
12–14.5s: Oil texture spreads from the edges inward without moving or replacing figures. Complete the painting as the camera reaches its final framing.
14.5–15s: Hold completely still.
Preserve reference identities, costumes, weapons, lighting and colours. Warm side light, deep archway shadows, realistic material weight. Show the full uncropped painting at its original aspect ratio, centred against darkness.
Bootsteps, fabric, metal and drums accompany rising orchestral music; only fading musical resonance remains after the freeze. No cuts, extra characters, premature brushwork, text or watermarks.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-029.77fbf76ab05b62eb.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-029.1c6b164ffd34de49.d1a604f79cd8d5fe.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/image-to-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "15s, one continuous shot. Recreate the figures and setting of @Image1 as photorealistic live action, then transform them into that exact painting. 0–3s: Low tracking view of militia boots crossing stone beneath a dark archway. Move backward through a clear gap and tilt upward. 3–8s: Reveal the black-clad captain with red sash extending his hand, the pale-gold lieutenant stepping beside him, and the reference figures adjusting formation. 8–12s: Pull back and rise slightly. Everyone settles into the exact reference composition. At 11.5s, figures and drums stop; the scene remains photorealistic. 12–14.5s: Oil texture spreads from the edges inward without moving or replacing figures. Complete the painting as the camera reaches its final framing. 14.5–15s: Hold completely still. Preserve reference identities, costumes, weapons, lighting and colours. Warm side light, deep archway shadows, realistic material weight. Show the full uncropped painting at its original aspect ratio, centred against darkness. Bootsteps, fabric, metal and drums accompany rising orchestral music; only fading musical resonance remains after the freeze. No cuts, extra characters, premature brushwork, text or watermarks."
    },
    {
      "type": "last_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_night_watch_last_frame.jpg",
      "id": "Image1"
    }
  ],
  "settings": {
    "resolution": "1080p"
  }
}'
```

#### ④ Intermediate Frames

For each keyframe, add a description explaining what happens at that visual node and how the camera reaches it.

```text
X-Ys | Keyframe 1: [what happens]
Y-Zs | Keyframe 2: [what happens]
A-Bs | Keyframe 3: [what happens]
```

**Applicable scenario:** Projects that already have a storyboard and need to translate each key visual into specific timeline positions.

::::: container guide-case

:::: container guide-case-input

<p class="guide-case-label">Input</p>

<div class="guide-case-media-list">
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-032.ef6e9de68d1f502e.f0a877898697b819.webp" alt="" /></div>

<p>Image 1</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-030.f0a90d4dccc4e63b.9e34a977730bd9da.webp" alt="" /></div>

<p>Image 2</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-028.9e44e35eae8bea25.85cad688cf2f72a1.webp" alt="" /></div>

<p>Image 3</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-031.07028a0b37a6f8c9.6a32ce7df2cca1e2.webp" alt="" /></div>

<p>Image 4</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-025.9c3af65d9f2ee722.f0db2479d813d96d.webp" alt="" /></div>

<p>Image 5</p>
</div>
<div class="guide-case-shot">

<div class="media-wrap image-wrap"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-i-029.2655b6fcda7da850.dc9b55c7c03d2806.webp" alt="" /></div>

<p>Image 6</p>
</div>
</div>

```text
15s, exactly one consistent girl, six reference-matched shots followed by a fade to black. Preserve each keyframe’s identity, clothing, room layout, lighting and composition. Soft mint-green palette, restrained movement, natural fabric response. Hard cuts between poses; no morphing.
0–2.1s @Image1
Wide view: seated on the tiled floor against the cabinet and wall corner, legs naturally extended, hands between her knees. Slowly lift her lowered gaze toward the window. Curtains barely stir; subtle 3% push-in.
2.1–4.3s @Image2
A recorder note begins 0.1s before the cut. Medium close-up: eyes closed, play the white recorder with one brief exhalation and minimal finger movement. Preserve instrument shape and natural hand anatomy. Camera steady.
4.3–6.5s @Image3
Cut as the note ends. Standing beside the window, hands beside the right cheek. Hold a lowered gaze briefly, then look into the lens and gently curl the fingers once. Bracelet catches window light; slight push-in.
6.5–8.5s @Image4
Low detail of lace skirt, white stockings, pale-green Mary Janes and one hand on the tall cabinet edge. Legs together, feet suspended. One small forward swing, then return to rest.
8.5–10.8s @Image5
Lying on her stomach, face supported by both hands, feet raised. Look from camera to left window and back. Shoe tips cross once, subtly. Preserve bedding and furnishings.
10.8–13.5s @Image6
Seated on the white chair, wearing the exact transparent glasses. One paper sheet drifts diagonally across the foreground, briefly overlapping forehead and shoulder while leaving her eyes readable. Blink once, tilt her head slightly right and hold as the paper exits.
13.5–15s
Hold the final pose. Fade the entire image evenly to black without changing colour temperature. No text or additional characters.
```

:::: container guide-case-output

<p class="guide-case-label">Output</p>

<button type="button" class="guide-video-poster" data-src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-v-032.d3dc6854b5a45bd9.mp4" aria-label="Play video"><img src="https://s15-kling.klingai.com/kos/s101/nlav112918/api-doc/zh-p-032.fc39f44c65f07f3a.8ad7a737740dab74.webp" alt="" /></button>

API example

```cURL
curl -sS --request POST \
  'https://api-singapore.klingai.com/image-to-video/kling-4.0' \
  --header "Authorization: Bearer ${KLING_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "15s, exactly one consistent girl, six reference-matched shots followed by a fade to black. Preserve each keyframe’s identity, clothing, room layout, lighting and composition. Soft mint-green palette, restrained movement, natural fabric response. Hard cuts between poses; no morphing. 0–2.1s @Image1 Wide view: seated on the tiled floor against the cabinet and wall corner, legs naturally extended, hands between her knees. Slowly lift her lowered gaze toward the window. Curtains barely stir; subtle 3% push-in. 2.1–4.3s @Image2 A recorder note begins 0.1s before the cut. Medium close-up: eyes closed, play the white recorder with one brief exhalation and minimal finger movement. Preserve instrument shape and natural hand anatomy. Camera steady. 4.3–6.5s @Image3 Cut as the note ends. Standing beside the window, hands beside the right cheek. Hold a lowered gaze briefly, then look into the lens and gently curl the fingers once. Bracelet catches window light; slight push-in. 6.5–8.5s @Image4 Low detail of lace skirt, white stockings, pale-green Mary Janes and one hand on the tall cabinet edge. Legs together, feet suspended. One small forward swing, then return to rest. 8.5–10.8s @Image5 Lying on her stomach, face supported by both hands, feet raised. Look from camera to left window and back. Shoe tips cross once, subtly. Preserve bedding and furnishings. 10.8–13.5s @Image6 Seated on the white chair, wearing the exact transparent glasses. One paper sheet drifts diagonally across the foreground, briefly overlapping forehead and shoulder while leaving her eyes readable. Blink once, tilt her head slightly right and hold as the paper exits. 13.5–15s  Hold the final pose. Fade the entire image evenly to black without changing colour temperature. No text or additional characters."
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_floor_pose.png",
      "id": "Image1"
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_recorder_closeup.png",
      "id": "Image2"
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_window_pose.png",
      "id": "Image3"
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_dangling_feet.png",
      "id": "Image4"
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_bed_pose.png",
      "id": "Image5"
    },
    {
      "type": "middle_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_9_mint_paper_chair_pose.png",
      "id": "Image6"
    }
  ],
  "settings": {
    "resolution": "1080p"
  }
}'
```
