GET
https://octopusx.ai
/
v1
/
video
/
query
Query Task
curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'
{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "object": "video",
  "model": "sora-2",
  "status": "pending",
  "progress": "0",
  "created_at": 1762010621,
  "size": "large",
  "status_update_time": 1762010621323,
  "detail": {
    "input": {
      "prompt": "make animate",
      "model": "sora-2",
      "images": [],
      "aspect_ratio": "9:16"
    }
  }
}

​
Query Task

After a Sora unified video task is submitted, query its progress and result through GET /v1/video/query. 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, and the format is usually sora-2:task_....
  • The response structure is consistent with the OpenAI VIDEO format and may include fields such as status, progress, detail, and video_url.

​
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": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "object": "video",
  "model": "sora-2",
  "status": "pending",
  "progress": "0",
  "created_at": 1762010621,
  "size": "large",
  "status_update_time": 1762010621323,
  "detail": {
    "input": {
      "prompt": "make animate",
      "model": "sora-2",
      "images": [],
      "aspect_ratio": "9:16"
    }
  }
}
Some channels also return a more complete detail structure when pending or completed. Please perform compatible parsing based on the actual response.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
id
string
required
Task ID, which matches the id returned by the creation interface.

​
Response

​
id
string
Task ID.
​
object
string
Object type, commonly video.
​
model
string
The actual model name used.
​
status
string
Task status; common values include pending, queued, processing, completed, failed, and cancelled.
​
progress
string | integer
Task progress.
​
created_at
integer
Creation time (Unix timestamp).
​
size
string
Output specification.
​
detail
object
Task details, usually including echoed input and upstream metadata.
​
video_url
string
Video result URL, appears after completion.
​
status_update_time
integer
Most recent status update time (Unix timestamp).