Skip to main content
GET
https://vibetool.ai
/
v1
/
videos
/
status
/
{task_id}
curl -X GET [https://vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08](https://vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08) \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "task_id": "vid_202512261557_b4fcbb08",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/video.mp4",
  "thumbnail_url": "https://example.com/thumbnail.jpg",
  "duration": 4,
  "error": null,
  "created_at": 1767072426,
  "updated_at": 1767072433,
  "completed_at": 1767072433
}

​
Authorization

​
Authorization
string
required
All APIs require Bearer Token authentication. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
task_id
string
required
Task ID. Ignore {} when querying. Append the task_id returned from the async task creation response to the end of the path.

​
Response Schema

Task status details.
​
task_id
string
required
Task ID.
​
progress
integer
Task progress percentage.Required range: 0 <= x <= 100
​
status
enum<string>
required
Task status.Available options: pending, processing, completed, failed
​
video_url
string | null
Generated video URL (present when status is completed, valid for 24 hours).
​
thumbnail_url
string | null
Thumbnail URL (if provided).
​
duration
number | null
Video duration in seconds (if provided).
​
error
string | null
Error information (present when status is failed).
​
created_at
integer | string | null
Created timestamp.
​
updated_at
integer | string | null
Updated timestamp.
​
completed_at
integer | string | null
Completed timestamp.
curl -X GET [https://vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08](https://vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08) \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "task_id": "vid_202512261557_b4fcbb08",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/video.mp4",
  "thumbnail_url": "https://example.com/thumbnail.jpg",
  "duration": 4,
  "error": null,
  "created_at": 1767072426,
  "updated_at": 1767072433,
  "completed_at": 1767072433
}