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​

{}