GET
https://octopusx.ai
/
v1
/
video
/
query
Query Task
curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "grok:05c8e247-7e64-472a-acb1-e7f2de5d0d04",
  "status": "processing",
  "video_url": null,
  "status_update_time": 1762780400,
  "progress": 50
}

​
Query Task

After a Grok unified video task is submitted, query its progress and results via GET /v1/video/query. The query parameter uses id, whose value is the task ID returned by Create Video.
  • The route entry point is GET /v1/video/query.
  • The task ID is passed via the Query parameter id, and its format is usually grok:....
  • After completion, video_url will include an accessible URL; while processing, it may be null.

​
Method and Path

GET /v1/video/query?id={task_id}

​
Request Example

curl "https://octopusx.ai/v1/video/query?id=grok:48a67431-0708-46d1-9ab9-83cb84700153" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
Response Example

{
  "id": "grok:05c8e247-7e64-472a-acb1-e7f2de5d0d04",
  "status": "processing",
  "video_url": null,
  "status_update_time": 1762780400,
  "progress": 50
}
Some channels may also return extended fields such as asset_id, video_file_id, and trace_id; please refer to the actual response.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
id
string
required
Task ID, which is the same as the id returned by the creation API.

​
Response

​
id
string
Task ID.
​
status
string
Task status. Common values include processing, completed, failed, and unknown.
​
video_url
string | null
Video result URL. May be null when the task is not yet complete.
​
status_update_time
integer
The most recent status update time (Unix timestamp).
​
progress
integer
Task progress percentage, included in some responses.
​
prompt
string
Echo of the submitted prompt.
​
ratio
string
Echo of the video ratio, for example 3:2.
​
thumbnail_url
string
Thumbnail URL, may appear after completion.