GET
https://octopusx.ai
/
v1
/
video
/
query
Query Task
curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "",
  "status_update_time": 1759763621142
}

​
Query Task

After a Veo unified video task is submitted, use GET /v1/video/query to check its progress and result. The query parameter uses id, whose value is the task ID returned by Create Video.
  • The route entry is GET /v1/video/query.
  • The task ID is passed in via the id query parameter.
  • While processing, statuses such as pending or processing are commonly returned; after completion, video_url will include an accessible address.

​
Method and Path

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

​
Request Example

curl "https://octopusx.ai/v1/video/query?id=sora-2:task_01k74ynm13exf9ha36zz7820hv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
Response Example

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "",
  "status_update_time": 1759763621142
}
Some channels also return a more complete detail structure when pending or completed (including upstream task metadata, thumbnails, progress percentage, and more). Please parse compatibly according to the actual response.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
id
string
required
Task ID, consistent with the id returned by the create interface.

​
Response

​
id
string
Task ID.
​
status
string
Task status; common values include pending, processing, completed, and failed.
​
video_url
string | null
The video result URL. It may be null when the task is not yet complete.
​
enhanced_prompt
string
The enhanced prompt; may be an empty string if enhancement is not enabled.
​
status_update_time
integer
The most recent status update time (Unix timestamp, in milliseconds or seconds depending on the upstream source; please refer to the actual response).