GET
https://octopusx.ai
/
v1
/
video
/
generations
/
{task_id}
Query Task
curl --request GET \
  --url https://octopusx.ai/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "data": {
    "task_id": "task_xxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 0,
    "data": {
      "status": "processing",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

​
Query Task

Query the task status, progress, and result video URL based on the task_id returned by Create Video.

​
Method and Path

GET /v1/video/generations/{task_id}

​
Request Example

curl https://octopusx.ai/v1/video/generations/cgt-20260412163502-x8k2m \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
Response Example

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 0,
    "data": {
      "status": "processing",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
task_id
string
required
Video generation task ID, consistent with the task_id returned by the creation endpoint.

​
Response

​
code
string
Response code, success on success.
​
data.task_id
string
Task ID.
​
data.status
string
Task status: SUBMITTED, IN_PROGRESS, SUCCESS, FAILURE.
​
data.progress
string
Progress string, such as 50% or 100%.
​
data.fail_reason
string
Reason for failure, present only when status=FAILURE.
​
data.data.status
string
Upstream native status: queued, pending, processing, succeeded, failed.
​
data.data.content.video_url
string
Generated video URL (usually a temporary signed link, valid for about 12 hours by default).
​
data.data.usage.total_tokens
integer
Token usage related to billing.