Skip to content

Get Kling text-to-video task status

GET
/kling/v1/videos/text2video/{task_id}
curl --request GET \
--url https://api.mirapi.ai/kling/v1/videos/text2video/task-abc123 \
--header 'Authorization: Bearer <token>'

Returns the status and result of a Kling text-to-video task.

task_id
required
string

Task ID

Example
task-abc123

Task status returned

Media typeapplication/json

Video task status response

object
task_id

Task ID

string
status

Task status

string
Allowed values: queued in_progress completed failed
url

Video URL (on success)

string
format

Video format

string
metadata

Video task metadata

object
duration

Actual duration of the generated video

number
fps

Actual frame rate

integer
width

Actual width

integer
height

Actual height

integer
seed

Random seed used

integer
error

Video task error

object
code

Error code

integer
message

Error message

string
Example
{
"task_id": "abcd1234efgh",
"status": "queued",
"url": "https://example.com/video.mp4",
"format": "mp4",
"metadata": {
"duration": 5,
"fps": 30,
"width": 1280,
"height": 720,
"seed": 20231234
}
}

Task not found

Media typeapplication/json
object
error
object
message

Error message

string
type

Error type

string
param

Related parameter

string
nullable
code

Error code

string
nullable
Examplegenerated
{
"error": {
"message": "example",
"type": "example",
"param": "example",
"code": "example"
}
}