Skip to main content

Kling AI - Image to Video

Transform static images into dynamic videos using Kling AI's sophisticated image-to-video generation technology with extensive customization options including multiple aspect ratios, quality modes, and advanced generation controls.

Note: Image files must first be uploaded using the Asset API before processing. The imageUrl parameter should contain the path returned from the Asset API upload.

Endpoint

Request Headers

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Request Parameters

Field NameTypeExampleDescriptionRequired
typestringIMAGE_TO_VIDEOFeature identifier✔️
modelstringklingAI model to use✔️
conversationIdstringIMAGE_TO_VIDEOConversation context
promptObject.imageUrlstringimages/example.jpgSource image path from Asset API upload✔️
promptObject.promptstringgentle waves movingText description of desired motion/scene. For version 3.0 / 3.0 Omni this is ignored when multi_shots is provided
promptObject.durationnumber5Duration of video in seconds. Versions below 3.0: 5 or 10. Versions 3.0 & 3.0 Omni: any integer from 3 to 15✔️
promptObject.aspect_ratiostring16:9Video aspect ratio (16:9, 9:16, 1:1)✔️
promptObject.modestringstdQuality mode (std or pro). Required for all versions except 3.0 Omni (which uses resolution instead). Versions 2.0 and 2.5 only support pro✔️
promptObject.versionstring2.0Model version (1.0, 1.5, 1.6, 2.0, 2.1, 2.1-master, 2.5, 3.0, 3.0-omni)✔️
promptObject.imageTailUrlstringimages/end.jpgEnd frame image path from Asset API upload. Supported in pro mode for versions 1.0, 1.6, 2.0, 2.5, and in any mode for version 3.0. Not supported for 3.0 Omni
promptObject.cfg_scalenumber0.5CFG scale for generation control (0-1). Applies to versions below 3.0 only
promptObject.negative_promptstringpeople, buildingsWhat not to include in the video
promptObject.camera_control_typestringdefaultCamera movement type (not available for version 1.5). Applies to versions below 3.0 only
promptObject.camera_control_valuenumber0Camera control intensity (-10 to 10, requires camera_control_type other than 'default'). Applies to versions below 3.0 only

Version 3.0 & 3.0 Omni Parameters

These parameters apply only to versions 3.0 and 3.0-omni. For these versions, cfg_scale and the camera control fields are not used.

Field NameTypeExampleDescriptionRequired
promptObject.resolutionstring720pOutput resolution (720p or 1080p). Required for 3.0-omni and replaces mode✔️ (3.0-omni)
promptObject.enable_audiobooleantrueGenerate synchronized audio for the video. Affects credit cost
promptObject.multi_shotsarraysee belowList of shots to render as a single multi-shot video. When provided, the top-level prompt and duration are ignored
promptObject.additional_imagesarray["images/ref2.jpg"]3.0 Omni only. Up to 3 extra reference image paths (4 total including imageUrl). Reference them in your prompt as @image_1 (the main imageUrl), @image_2, @image_3, etc.

multi_shots — an array of up to 6 shot objects. The total duration across all shots must not exceed 15 seconds. Each shot object:

Field NameTypeExampleDescriptionRequired
promptstringthe subject turns toward the cameraDescription for this shot✔️
durationnumber3Shot duration in seconds (1–14). Defaults to 3 if omitted

When multi_shots is used, credit is calculated from the sum of each shot's duration rather than the top-level duration field.

Code Examples

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_TO_VIDEO",
"model": "kling",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
"imageUrl": "images/2025_10_22_07_10_43_846_elon-musk.jpg",
"prompt": "gentle waves rolling on a peaceful beach with soft sunlight",
"duration": 5,
"aspect_ratio": "16:9",
"mode": "pro",
"version": "2.0",
"cfg_scale": 0.5,
"negative_prompt": "people, buildings"
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Path to the source image file uploaded via Asset API
Choose the duration for your generated video
Choose the aspect ratio for your video output
Select quality mode - Professional offers more control options
Select the Kling AI model version for video generation
Controls how closely the generation follows the prompt (0-1, higher values = stricter adherence)
Describe elements you want to avoid in the generated video
Camera movement intensity

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "IMAGE_TO_VIDEO",
"model": "kling",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
"imageUrl": "images/2025_10_22_07_10_43_846_elon-musk.jpg",
"prompt": "gentle waves rolling on a peaceful beach with soft sunlight",
"duration": 5,
"aspect_ratio": "16:9",
"mode": "pro",
"version": "2.0",
"cfg_scale": 0.5,
"negative_prompt": "people, buildings"
}
}'

Response

{}