Skip to main content
GET
/
v1
/
videos
/
tasks
/
{task_id}
Get Video Task
curl --request GET \
  --url https://openapi.imini.ai/imini/router/v1/videos/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "task_2042864638838083584",
  "status": "succeeded",
  "model": "kling/kling-v3",
  "created_at": "2026-04-11T07:17:39.146Z",
  "completed_at": "2026-04-11T07:19:57.844Z",
  "videos": [
    {
      "url": "https://file.iminicdn.com/file/2026/04/11/2042865212863942656.mp4",
      "width": 1284,
      "height": 716,
      "duration": 5,
      "cover_url": "https://file.iminicdn.com/file/2026/04/11/2042865212863942700.jpg"
    }
  ],
  "error": null,
  "request_id": "req_abc123"
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <YOUR_API_KEY> in the request header. Go to the API Keys management page to create and manage API Keys.

Path Parameters

​
task_id
string
required

Unique task ID, returned by the video generation endpoint.

Example:

"task_2042864638838083584"

Response

Query successful

​
task_id
string

Unique task ID

Example:

"task_2042864638838083584"

​
status
enum<string>

Task status:

  • queued — Submitted, waiting in queue
  • processing — Model is generating
  • succeeded — Generation succeeded
  • failed — Generation failed, see the error field
Available options:
queued,
processing,
succeeded,
failed
Example:

"succeeded"

​
model
string

The model ID used for this task

Example:

"kling/kling-v3"

​
created_at
string<date-time>

Task creation time (ISO 8601)

Example:

"2026-04-11T07:17:39.146Z"

​
completed_at
string<date-time> | null

Task completion time (ISO 8601); null while not yet completed

Example:

"2026-04-11T07:19:57.844Z"

​
videos
object[] | null

Generation result list. Populated when status is succeeded, otherwise null.

​
error
object

Error information. Populated when status is failed, otherwise null.

​
request_id
string

Unique request ID

Example:

"req_abc123"