Retrieve specific Kling task

April 18, 2025

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

This endpoint retrieves information about a specific task by its ID.

https://api.useapi.net/v1/kling/tasks/task_id?…

The task_id value should be a numeric identifier of the task you want to retrieve.

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • email is optional when only one account configured.
    However, if you have multiple accounts configured, this parameter becomes required.
Responses

  • 200 OK

    {
  "status": 99,
  "status_name": "succeed",
  "status_final": true,
  "etaTime": 0,
  "etaTimeOverSla": false,
  "queuingEtaTime": 0,
  "originEtaTime": 0,
  "originQueuingEtaTime": 0,
  "message": "success",
  "task": {
    "id": 123456789,
    "userId": 12345,
    "type": "m2v_img2video_hq",
    "scene": "NORMAL_CREATION",
    "status": 99,
    "status_name": "succeed",
    "status_final": true,
    "taskInfo": {
      "type": "m2v_img2video_hq",
      "inputs": [
        {
          "name": "input",
          "inputType": "URL",
          "token": null,
          "blobStorage": null,
          "url": "https://s21-kling.klingai.com/....jpg",
          "cover": null,
          "fromWorkId": null
        }
      ],
      "arguments": [
        {
          "name": "prompt",
          "value": "A person dancing"
        },
        {
          "name": "negative_prompt",
          "value": ""
        },
        {
          "name": "duration",
          "value": "5"
        },
        {
          "name": "kling_version",
          "value": "2.0"
        }
      ],
      "extraArgs": {},
      "callbackPayloads": [],
      "scene": "NORMAL_CREATION"
    },
    "favored": false,
    "deleted": false,
    "viewed": true,
    "createTime": 1744858514499,
    "updateTime": 1744858823172,
    "viewTime": 1744916388016
  },
  "works": [
    {
      "workId": 123456789,
      "workItemId": 0,
      "taskId": 123456789,
      "userId": 12345,
      "type": "m2v_img2video_hq",
      "status": 99,
      "status_name": "succeed",
      "status_final": true,
      "contentType": "video",
      "resource": {
        "resource": "https://s21-kling.klingai.com/....mp4",
        "height": 1268,
        "width": 724,
        "duration": 5041,
        "resourceKey": ""
      },
      "cover": {
        "resource": "https://s21-kling.klingai.com/....jpg",
        "height": 1268,
        "width": 724,
        "duration": 0,
        "resourceKey": ""
      },
      "starNum": 0,
      "cloneCount": 0,
      "reportNum": 0,
      "createTime": 1744858514515,
      "taskInfo": {
        "type": "m2v_img2video_hq",
        "inputs": [
          {
            "name": "input",
            "inputType": "URL",
            "token": null,
            "blobStorage": null,
            "url": "https://s21-kling.klingai.com/....jpg",
            "cover": null,
            "fromWorkId": null,
            "fromUploadId": null
          }
        ],
        "arguments": [
          {
            "name": "prompt",
            "value": "A person dancing"
          },
          {
            "name": "negative_prompt",
            "value": ""
          },
          {
            "name": "duration",
            "value": "5"
          },
          {
            "name": "kling_version",
            "value": "2.0"
          }
        ],
        "extraArgs": {},
        "callbackPayloads": [],
        "scene": "NORMAL_CREATION"
      },
      "selfAttitude": "unknown",
      "selfComment": {
        "rate": 0,
        "tags": [],
        "content": "",
        "prompts": []
      },
      "favored": false,
      "starred": false,
      "publishStatus": "unpublished",
      "deleted": false,
      "publishTime": 0,
      "submitTime": 1744858514515,
      "lipSyncStatus": 99,
      "downloadInfo": {
        "fileTypes": [
          {
            "type": "MP4",
            "watermark": true
          }
        ]
      },
      "allowPublish": true
    }
  ],
  "currentTimestamp": 1744955215247
}

  • 400 Bad Request

    {
  "error": "Invalid task_id parameter"
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 404 Not Found

    {
  "error": "Task not found"
}
Model

List of known status values:

status status_name status_final Notes
5 submitted false  
6 failed true  
7 failed true The input prompt contains sensitive words
9 failed true Change the input prompt and try again
10 processing false  
50 failed true Change the input prompt and try again
99 succeed true  

To download assets without watermarks, use the GET /assets/download endpoint with the workId values found in the works array of the response.

{ // TypeScript, all fields are optional
  status: number
  status_name: string
  status_final: boolean
  etaTime: number
  etaTimeOverSla: boolean
  queuingEtaTime: number
  originEtaTime: number
  originQueuingEtaTime: number
  message: string
  task: {
    id: number
    userId: number
    type: string
    scene: string
    status: number
    status_name: string
    status_final: boolean
    taskInfo: {
      type: string
      inputs: {
        name: string
        inputType: string
        token: string | null
        blobStorage: string | null
        url: string
        cover: string | null
        fromWorkId: number | null
      }[]
      arguments: {
        name: string
        value: string
      }[]
      extraArgs: Record<string, any>
      callbackPayloads: any[]
      scene: string
    }
    favored: boolean
    deleted: boolean
    viewed: boolean
    createTime: number
    updateTime: number
    viewTime: number
  }
  works: {
    workId: number
    workItemId: number
    taskId: number
    userId: number
    type: string
    status: number
    status_name: string
    status_final: boolean
    contentType: string
    resource: {
      resource: string
      height: number
      width: number
      duration: number
      resourceKey: string
    }
    cover: {
      resource: string
      height: number
      width: number
      duration: number
      resourceKey: string
    }
    starNum: number
    cloneCount: number
    reportNum: number
    createTime: number
    taskInfo: {
      type: string
      inputs: {
        name: string
        inputType: string
        token: string | null
        blobStorage: string | null
        url: string
        cover: string | null
        fromWorkId: number | null
        fromUploadId: number | null
      }[]
      arguments: {
        name: string
        value: string
      }[]
      extraArgs: Record<string, any>
      callbackPayloads: any[]
      scene: string
    }
    selfAttitude: string
    selfComment: {
      rate: number
      tags: any[]
      content: string
      prompts: any[]
    }
    favored: boolean
    starred: boolean
    publishStatus: string
    deleted: boolean
    publishTime: number
    submitTime: number
    lipSyncStatus: number
    downloadInfo: {
      fileTypes: {
        type: string
        watermark: boolean
      }[]
    }
    allowPublish: boolean
  }[]
  currentTimestamp: number
}
Examples 
  • curl "https://api.useapi.net/v1/kling/tasks/[email protected]" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const email = "Previously configured account email";
const taskId = "123456789";
const apiUrl = `https://api.useapi.net/v1/kling/tasks/${taskId}?email=${email}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
email = "Previously configured account email"
task_id = "123456789"
apiUrl = f"https://api.useapi.net/v1/kling/tasks/{task_id}?email={email}"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It