GET
https://octopusx.ai
/
v1
/
videos
/
{task_id}
Vidu Task Status Query
curl --request GET \
  --url https://octopusx.ai/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_123",
  "object": "video",
  "model": "viduq3-pro",
  "status": "processing",
  "progress": 50,
  "created_at": 1712697600,
  "size": "1024x1808",
  "seconds": "5",
  "quality": "standard"
}

​
Vidu Task Status Query

After submitting a Vidu series task, query it through GET /v1/videos/{task_id}.
  • The query path is GET /v1/videos/{task_id}.
  • A successful response returns an OpenAI-style video object.
  • After the task is completed, you can read the result from video_url.

​
Method and Path

GET /v1/videos/{task_id}

​
Request Example

curl https://octopusx.ai/v1/videos/video_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "id": "video_123",
  "object": "video",
  "model": "viduq3-pro",
  "status": "processing",
  "progress": 50,
  "created_at": 1712697600,
  "size": "1024x1808",
  "seconds": "5",
  "quality": "standard"
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

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

​
Response

​
id
string
Task ID.
​
object
string
Always video.
​
model
string
Model name.
​
status
string
Task status. Possible values include processing (processing), failed (failed), and completed (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 or failed.
​
size
string
Video size, for example 1024x1808.
​
seconds
string
Video duration (seconds).
​
quality
string
Video quality, for example standard.
​
video_url
string
Video download URL, returned only in the completed status.
​
error
object
Error information, returned only in the failed status.
​
error.message
string
Error message.
​
error.code
string
Error code.