Skip to main content
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

ActionDescription
text2videoText-to-video and Omni video tasks
image2videoImage-to-video tasks
generationsImage generation tasks
lip-syncLip sync video tasks
kolors-virtual-try-onVirtual try-on image tasks

​
Quick Example

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

​
Response Fields

FieldTypeDescription
codestringResponse code (success)
data.task_idstringTask ID
data.statusstringSUBMITTED, PROCESSING, SUCCESS, or FAILED
data.progressstringProgress percentage (e.g. 10%, 100%)
data.submit_timeintegerSubmission Unix timestamp
data.start_timeintegerProcessing start Unix timestamp
data.finish_timeintegerCompletion Unix timestamp
data.data.data.task_resultobjectContains videos or images array with download URLs

API Reference

View the interactive API Playground for Kling Task Query.