GET
https://octopusx.ai
/
v1
/
video
/
query
Query Task
curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

​
Query Task

After a Vidu unified video task is submitted, use GET /v1/video/query to query 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 Query parameter id.
  • The returned structure includes fields such as status, progress, and video_url.

​
Method and Path

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

​
Request Example

curl "https://octopusx.ai/v1/video/query?id=48038932-0ff5-4251-8b4b-7a76c09fd114" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

​
Response Example

{
  "id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

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

​
Response

​
id
string
Task ID.
​
status
string
Task status; common values include processing, failed, and completed.
​
progress
integer
Progress percentage (0-100).
​
created_at
integer
Creation time (Unix timestamp).
​
completed_at
integer
Completion time (Unix timestamp), returned only when the task is completed.
​
video_url
string
Video download URL, returned only when the status is completed.