kling-v3.0-4k-image-to-video

POST

/openapi/v2/kling-v3-4k/image-to-video

Kuaishou's flagship image-to-video model generating 4K video from reference images. Supports start/end frame control to define motion arcs. Features physics-aware motion for natural behavior of fluids, fabric, and hair. Offers 3-15s duration and optional synchronized sound.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "imageUrl": "https://www.runninghub.cn/view?filename=13192fd58460c4d05357c007e52d8333512f14fa8703da9e73e6b6f11b7f1c73.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Nzc2Mjk4OTk1OTQsInRzIjoxNzc3MDI1MDk5NTk0LCJzaWduIjoiYTgzYzQ0ZWFiNzg0NDk2Yjc0Y2IyNmNiMTVmNDk1NTkifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8259879219118293",
    "prompt": "A man is shown in profile, slightly tilting his head up to look at the sky, rain slowly dripping, neon lights shimmering in the water on the ground.",
    "duration": 5,
    "cfgScale": 0.5,
    "sound": false,
    "shotType": "customize"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/kling-v3-4k/image-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageUrl": "https://www.runninghub.cn/view?filename=13192fd58460c4d05357c007e52d8333512f14fa8703da9e73e6b6f11b7f1c73.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Nzc2Mjk4OTk1OTQsInRzIjoxNzc3MDI1MDk5NTk0LCJzaWduIjoiYTgzYzQ0ZWFiNzg0NDk2Yjc0Y2IyNmNiMTVmNDk1NTkifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8259879219118293",
    "prompt": "A man is shown in profile, slightly tilting his head up to look at the sky, rain slowly dripping, neon lights shimmering in the water on the ground.",
    "duration": 5,
    "cfgScale": 0.5,
    "sound": false,
    "shotType": "customize"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-04-30 12:00:08

kling-video-o1/image-to-video

kling-video-o1/start-to-end