## Basic tool info Model name: klingai/kling-v2.6 Model description: Kling v2.6 is a unified multimodal model designed to solve the "silent video" problem of previous generations. Unlike v2.5, which focused on physical simulation, v2.6 focuses on sensory immersion. It understands the semantic link between visual motion and sound—automatically generating the sound of footsteps when a character runs, or lip-synced dialogue when a character speaks. Model cover: https://cdn.wiro.ai/uploads/models/klingai-kling-v2-6-cover.mp4 Model categories: - tool - klingai - partner - text-to-video - image-to-video - nogpu-pipeline Model tags: - video generator - klingai Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/klingai/kling-v2-6 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: mode label: Mode help: Resolution mode. Sound requires Professional (1080p). First + last frame always uses 1080p. type: select default: pro options: - value: "std" label: Standard (720p) - value: "pro" label: Professional (1080p) - name: inputImage label: First Frame help: Optional. type: combinefileinput default: klingai-kling-2-6-input-2.jpg - name: inputImage2 label: Last Frame help: Optional. Sound will be off. Uses 1080p (pro). type: combinefileinput default: - name: prompt label: prompt help: The prompt to generate the video. type: textarea default: The man in the orange hat and blue jacket begins to walk slowly and deliberately forward across the rocky, grassy terrain towards the distant, jagged mountain range. As he moves, three high-performance stunt planes suddenly enter the frame rapidly from the left side of the sky, streaking across the upper background. They leave thick, white smoke trails behind them as they perform a synchronized banking maneuver. The mountains and foreground landscape remain perfectly stable. Clear daylight, high fidelity, cinematic motion. - name: negativePrompt label: Negative Prompt help: Specify what to exclude from the output. type: textarea default: - name: duration label: Duration help: Total duration of the generated video (in seconds) type: select default: 5 options: - value: "5" label: 5 - value: "10" label: 10 - name: ratio label: Ratio help: Required for text to video. Does not take effect when first frame image provided. type: select default: 16:9 options: - value: "16:9" label: 16:9 - value: "9:16" label: 9:16 - value: "1:1" label: 1:1 - name: sound label: Sound help: Optional. Default off. If there is last image then sound will be off. type: select default: off options: - value: "on" label: On - value: "off" label: Off ## Model Parameter Inspires: - prompt: The man in the orange hat and blue jacket begins to walk slowly and deliberately forward across the rocky, grassy terrain towards the distant, jagged mountain range. As he moves, three high-performance stunt planes suddenly enter the frame rapidly from the left side of the sky, streaking across the upper background. They leave thick, white smoke trails behind them as they perform a synchronized banking maneuver. The mountains and foreground landscape remain perfectly stable. Clear daylight, high fidelity, cinematic motion. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/klingai-kling-2-6-input-2.jpg - prompt: A sweeping crane shot starting from a low angle close to the vibrant orange marigold flowers, smoothly rising upwards to a high-angle, top-down perspective. The movement reveals the vast expanse of the flower field stretching towards the horizon, with the majestic snow-capped volcano and the smaller hill under a clear blue sky now seen from above. High fidelity, expansive landscape, photorealistic cinematic motion. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/klingai-kling-2-6-input-1.jpg - prompt: Extreme close-up of an elderly fisherman with a weathered face and a gray beard, wearing a yellow raincoat. He is standing on a boat deck in the rain. Raindrops run down his face. He looks directly into the camera with a calm, intense expression, then blinks slowly. Soft, diffused lighting, high skin detail, 85mm lens style, cinematic portrait. - inputImage: - prompt: A dirty white rally car drifting aggressively around a sharp corner on a gravel forest road. Clouds of dust and dirt are kicked up into the air behind the wheels. Sunlight flickers through the pine trees. The camera tracks the car from a low angle, shaking slightly to mimic handheld footage. High speed, motion blur, photorealistic, 4k. - inputImage: ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/klingai/kling-v2-6" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "mode": "pro", "inputImage": "klingai-kling-2-6-input-2.jpg", "inputImage2": [], "prompt": "The man in the orange hat and blue jacket begins to walk slowly and deliberately forward across the rocky, grassy terrain towards the distant, jagged mountain range. As he moves, three high-performance stunt planes suddenly enter the frame rapidly from the left side of the sky, streaking across the upper background. They leave thick, white smoke trails behind them as they perform a synchronized banking maneuver. The mountains and foreground landscape remain perfectly stable. Clear daylight, high fidelity, cinematic motion.", "negativePrompt": "", "duration": "5", "ratio": "16:9", "sound": "off", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "2221" }'; ``` ## Get Task Detail - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt" }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Kill Task - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "534574" }'; ``` ## Kill Task - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE" }'; ``` ## Kill Task - Response ```json { "errors": [], "tasklist": [ { "id": "534574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Cancel Task - Make HTTP Post Request (For tasks on queue) ```bash curl -X POST "https://api.wiro.ai/v1/Task/Cancel" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "634574" }'; ``` ## Cancel Task - Response ```json { "errors": [], "tasklist": [ { "id": "634574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.