Skip to content
klingai-image-to-video logo

Kling AI Image-to-Video

klingai-image-to-video

Animate static images into video using Kling AI. Use when converting

SKILL.md

Full skill instructions

Kling AI Image-to-Video

Overview

Animate static images using the /​v1/​videos/​image2video endpoint. Supports motion prompts, camera control, dynamic masks (motion brush), static masks, and tail images for start-to-end transitions.

Endpoint: POST https://api.klingai.com/​v1/​videos/​image2video

Request Parameters

ParameterTypeRequiredDescription
model_namestringYeskling-v1-5, kling-v2-1, kling-v2-master, etc.
imagestringYesURL of the source image (JPG, PNG, WebP)
promptstringNoMotion description for the animation
negative_promptstringNoWhat to exclude
durationstringYes"5" or "10" seconds
aspect_ratiostringNo"16:9" default
modestringNo"standard" or "professional"
cfg_scalefloatNoPrompt adherence (0.0-1.0)
image_tailstringNoEnd-frame image URL (mutually exclusive with masks/​camera)
camera_controlobjectNoCamera movement (mutually exclusive with masks/​image_tail)
static_maskstringNoMask image URL for fixed regions
dynamic_masksarrayNoMotion brush trajectories
callback_urlstringNoWebhook for completion

Basic Image-to-Video

import jwt, time, os, requests

BASE = "https://api.klingai.com/​v1"

def get_headers():
    ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
    token = jwt.encode(
        {"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
        sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
    )
    return {"Authorization": f"Bearer {token}", "Content-Type": "application/​json"}

# Animate a landscape photo
response = requests.post(f"{BASE}/​videos/​image2video", headers=get_headers(), json={
    "model_name": "kling-v2-1",
    "image": "https://example.com/​landscape.jpg",
    "prompt": "Clouds slowly drifting across the sky, gentle wind rustling through trees",
    "negative_prompt": "static, frozen, blurry",
    "duration": "5",
    "mode": "standard",
})

task_id = response.json()["data"]["task_id"]

# Poll for result
while True:
    time.sleep(15)
    result = requests.get(
        f"{BASE}/​videos/​image2video/​{task_id}", headers=get_headers()
    ).json()
    if result["data"]["task_status"] == "succeed":
        print(f"Video: {result['data']['task_result']['videos'][0]['url']}")
        break
    elif result["data"]["task_status"] == "failed":
        raise RuntimeError(result["data"]["task_status_msg"])

Start-to-End Transition (image_tail)

Use image_tail to specify both the first and last frame. Kling interpolates the motion between them.

response = requests.post(f"{BASE}/​videos/​image2video", headers=get_headers(), json={
    "model_name": "kling-v2-master",
    "image": "https://example.com/​sunrise.jpg",        # first frame
    "image_tail": "https://example.com/​sunset.jpg",    # last frame
    "prompt": "Time lapse of sun moving across the sky",
    "duration": "5",
    "mode": "professional",
})

Motion Brush (dynamic_masks)

Draw motion paths for specific elements in the image. Up to 6 motion paths per image in v2.6.

response = requests.post(f"{BASE}/​videos/​image2video", headers=get_headers(), json={
    "model_name": "kling-v2-6",
    "image": "https://example.com/​person-standing.jpg",
    "prompt": "Person walking forward naturally",
    "duration": "5",
    "dynamic_masks": [
        {
            "mask": "https://example.com/​person-mask.png",  # white = selected region
            "trajectories": [
                {"x": 0.5, "y": 0.7, "t": 0.0},   # start position (normalized 0-1)
                {"x": 0.5, "y": 0.5, "t": 0.5},   # midpoint
                {"x": 0.5, "y": 0.3, "t": 1.0},   # end position
            ]
        }
    ],
})

Static Mask (freeze regions)

Keep specific areas of the image static while animating the rest.

response = requests.post(f"{BASE}/​videos/​image2video", headers=get_headers(), json={
    "model_name": "kling-v2-master",
    "image": "https://example.com/​scene.jpg",
    "prompt": "Water flowing in the river, birds flying",
    "duration": "5",
    "static_mask": "https://example.com/​buildings-mask.png",  # white = frozen
})

Mutual Exclusivity Rules

These features cannot be combined in a single request:

Feature Set AFeature Set B
image_taildynamic_masks, static_mask, camera_control
dynamic_masks / static_maskimage_tail, camera_control
camera_controlimage_tail, dynamic_masks, static_mask

Image Requirements

ConstraintValue
FormatsJPG, PNG, WebP
Max size10 MB
Min resolution300x300 px
Max resolution4096x4096 px
Mask formatPNG with white (selected) / black (excluded)

Error Handling

ErrorCauseFix
400 invalid imageURL unreachable or wrong formatVerify image URL is publicly accessible
400 mutual exclusivityCombined incompatible featuresUse only one feature set per request
task_status: failedImage too complex or low qualityUse higher resolution, clearer source
Mask mismatchMask dimensions differ from sourceEnsure mask matches source image dimensions

Resources

More skills from jeremylongshore

openrouter-compliance-review logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-compliance-review

Review OpenRouter integration for regulatory compliance (SOC2, GDPR,

2.8K 0
View
maintainx-data-handling logo
jeremylongshore/claude-code-plugins-plus-skills

maintainx-data-handling

Data synchronization, ETL patterns, and data management for MaintainX.

2.8K 0
View
groq-core-workflow-a logo
jeremylongshore/claude-code-plugins-plus-skills

groq-core-workflow-a

Execute Groq primary workflow: chat completions with tool use and JSON

2.8K 0
View
validating-csrf-protection logo
jeremylongshore/claude-code-plugins-plus-skills

validating-csrf-protection

Validate CSRF protection implementations for security gaps. Use when

2.8K 0
View
api-contract logo
jeremylongshore/claude-code-plugins-plus-skills

api-contract

Configure this skill should be used when the user asks about "API contract",

2.8K 0
View
ideogram-incident-runbook logo
jeremylongshore/claude-code-plugins-plus-skills

ideogram-incident-runbook

Execute Ideogram incident response with triage, mitigation, and postmortem.

2.8K 0
View
gamma-sdk-patterns logo
jeremylongshore/claude-code-plugins-plus-skills

gamma-sdk-patterns

Reusable patterns for the Gamma REST API (no SDK exists).

2.8K 0
View
deepgram-sdk-patterns logo
jeremylongshore/claude-code-plugins-plus-skills

deepgram-sdk-patterns

Apply production-ready Deepgram SDK patterns for TypeScript and Python.

2.8K 0
View
openrouter-upgrade-migration logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-upgrade-migration

Migrate to OpenRouter from direct provider APIs or upgrade between SDK/model

2.8K 0
View
openrouter-common-errors logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-common-errors

Diagnose and fix common OpenRouter API errors. Use when encountering

2.8K 0
View
linear-cost-tuning logo
jeremylongshore/claude-code-plugins-plus-skills

linear-cost-tuning

Optimize Linear API usage, reduce unnecessary calls, and maximize

2.8K 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View