Kling Task Query - Starrise AI

The Kling Task Query endpoint checks the status of any Kling generation task and retrieves the result. This is the shared query endpoint for all Kling models (Omni, text-to-video, image-to-video, etc.).

Key Points

Universal query — Works for all Kling task types: video, image, lip sync, virtual try-on
Asynchronous workflow — Create a task first, then poll this endpoint until completion
Action parameter — Must match the task type of the original creation request
Progress tracking — Returns progress percentage and status updates

Action Types

Action	Description
`text2video`	Text-to-video and Omni video tasks
`image2video`	Image-to-video tasks
`generations`	Image generation tasks
`lip-sync`	Lip sync video tasks
`kolors-virtual-try-on`	Virtual try-on image tasks

Quick Example

curl https://ai.alad.com/kling/v1/videos/text2video/860260753860210752 \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests
import time

task_id = "860260753860210752"
action = "text2video"

while True:
    response = requests.get(
        f"https://ai.alad.com/kling/v1/videos/{action}/{task_id}",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    )

    result = response.json()
    status = result["data"]["status"]
    progress = result["data"]["progress"]
    print(f"Status: {status}, Progress: {progress}")

    if status in ["SUCCESS", "FAILED"]:
        break

    time.sleep(5)

if status == "SUCCESS":
    videos = result["data"]["data"]["data"]["task_result"]["videos"]
    for video in videos:
        print(f"Video URL: {video['url']}")

Response Fields

Field	Type	Description
`code`	string	Response code (`success`)
`data.task_id`	string	Task ID
`data.status`	string	`SUBMITTED`, `PROCESSING`, `SUCCESS`, or `FAILED`
`data.progress`	string	Progress percentage (e.g. `10%`, `100%`)
`data.submit_time`	integer	Submission Unix timestamp
`data.start_time`	integer	Processing start Unix timestamp
`data.finish_time`	integer	Completion Unix timestamp
`data.data.data.task_result`	object	Contains `videos` or `images` array with download URLs

API Reference

View the interactive API Playground for Kling Task Query.