Get Video Generation Task Status

Query the status and results of a video generation task.

Task statuses:

• queued: Queued
• in_progress: In Progress
• completed: Completed
• failed: Failed

Query Task

GET /v1/video/generations/{task_id}

Authentication: Bearer Token, format Authorization: Bearer <API Key>.

Path Parameters:

Parameter	Type	Required	Description
task_id	string	Yes	Task ID

cURL

curl -X GET 'https://neolink.com/api/v1/video/generations/<task_id>' \
--header 'Authorization: Bearer <API Key>'

Python

import requests

API_KEY = "<API Key>"
TASK_ID = "<task Id>"

url = f"https://neolink.com/api/v1/video/generations/{TASK_ID}"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

response = requests.get(url, headers=headers)
response.raise_for_status()

print(response.json())

Response Format

Success Response (HTTP 200)

Field	Type	Description
task_id	string	Task ID
status	string	Task status (queued / in_progress / completed / failed)
url	string	Video URL (returned on success)
format	string	Video format (e.g. mp4)
metadata	object	Video task metadata
metadata.duration	integer	Video duration (seconds)
metadata.fps	integer	Frame rate
metadata.width	integer	Video width
metadata.height	integer	Video height
metadata.seed	integer	Random seed
error	object	Error info object
error.code	integer	Error code
error.message	string	Error description

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

Error Response (HTTP 404)

Field	Type	Description
error	object	Error object
error.message	string	Error message
error.type	string	Error type
error.param	string	Related parameter
error.code	string	Error code

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Tip: This API queries the status of asynchronous video generation tasks. It is recommended to use a polling mechanism. When the status changes to completed, the generated video file can be accessed via the url field.