curl -X GET https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
url = "https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
r = requests.get(url, headers=headers, timeout=30)
print(r.status_code, r.json())
{
"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
}
{
"error": {
"message": "Invalid API Key provided",
"type": "authentication_error",
"param": null,
"code": 401
}
}
Video Generation
Get Video Result
Query the status, progress, and results of an asynchronous video generation task by task ID.
GET
/
v1
/
videos
/
status
/
{task_id}
curl -X GET https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
url = "https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
r = requests.get(url, headers=headers, timeout=30)
print(r.status_code, r.json())
{
"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
}
{
"error": {
"message": "Invalid API Key provided",
"type": "authentication_error",
"param": null,
"code": 401
}
}
Authorization
string
required
All APIs require Bearer Token authentication. Format:
Bearer YOUR_API_KEYPath Parameters
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
string
required
Task ID.
integer
Task progress percentage.Required range:
0 <= x <= 100enum<string>
required
Task status.Available options:
pending, processing, completed, failedstring | null
Generated video URL (present when
status is completed, valid for 24 hours).string | null
Thumbnail URL (if provided).
number | null
Video duration in seconds (if provided).
string | null
Error information (present when
status is failed).integer | string | null
Created timestamp.
integer | string | null
Updated timestamp.
integer | string | null
Completed timestamp.
curl -X GET https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
url = "https://api.vibetool.ai/v1/videos/status/vid_202512261557_b4fcbb08"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
r = requests.get(url, headers=headers, timeout=30)
print(r.status_code, r.json())
{
"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
}
{
"error": {
"message": "Invalid API Key provided",
"type": "authentication_error",
"param": null,
"code": 401
}
}
Authorizations
All APIs require Bearer Token authentication. Get your API Key from the dashboard and add to request header: Authorization: Bearer YOUR_API_KEY
Path Parameters
Task ID returned from the video generation request. Example: vid_202512261557_b4fcbb08
Example:
"vid_202512261557_b4fcbb08"
Response
Task status retrieved successfully
Task ID
Example:
"vid_202512261557_b4fcbb08"
Task status
Available options:
pending, processing, completed, failed Example:
"completed"
Task progress percentage (0-100)
Required range:
0 <= x <= 100Example:
100
Generated video URL (present when status is completed, valid for 24 hours)
Example:
"https://example.com/video.mp4"
Thumbnail URL (if provided)
Example:
"https://example.com/thumbnail.jpg"
Video duration in seconds (if provided)
Example:
4
Error information (present when status is failed)
Example:
null
Created timestamp
Example:
1767072426
Updated timestamp
Example:
1767072433
Completed timestamp
Example:
1767072433
Was this page helpful?