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

{
  "task_id": "img_202512301122_ff60b37b",
  "status": "completed",
  "progress": 100,
  "images": [
    { "url": "https://example.com/image.jpg", "revised_prompt": null }
  ],
  "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
​
images
object[]
Generated images (present when status is completed).
​
error
string | object | 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/images/status/img_202512301122_ff60b37b](https://vibetool.ai/v1/images/status/img_202512301122_ff60b37b) \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "task_id": "img_202512301122_ff60b37b",
  "status": "completed",
  "progress": 100,
  "images": [
    { "url": "https://example.com/image.jpg", "revised_prompt": null }
  ],
  "error": null,
  "created_at": 1767072426,
  "updated_at": 1767072433,
  "completed_at": 1767072433
}