Query Results
Poll Buble generation tasks and read image, video, or audio results.
Query Results
Generation tasks are asynchronous. After creating a task, poll it until the status becomes success or failed.
Endpoint
GET /api/v1/generations/[id]Request
curl https://buble.ai/api/v1/generations/YOUR_GENERATION_ID \
-H "Authorization: Bearer $BUBLE_API_KEY"Status values
| Status | Meaning |
|---|---|
pending | The task has been accepted and is waiting to run. |
processing | The provider is generating the output. |
success | Generation completed successfully. |
failed | Generation failed. Check error. |
canceled | Generation was canceled. |
Image result example
{
"data": {
"id": "task_id",
"status": "success",
"model": "google/nano-banana-pro",
"media_type": "image",
"mode": "text_to_image",
"cost_credits": 2,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:01:00.000Z",
"result": {
"images": [{ "url": "https://..." }]
}
}
}Video result example
{
"data": {
"id": "task_id",
"status": "success",
"model": "google/veo3.1-fast",
"media_type": "video",
"mode": "frames_to_video",
"cost_credits": 40,
"result": {
"videos": [
{
"url": "https://...",
"preview_url": "https://...",
"thumbnail_url": "https://...",
"duration": 8
}
]
}
}
}Failed task example
{
"data": {
"id": "task_id",
"status": "failed",
"model": "google/nano-banana-pro",
"media_type": "image",
"mode": "text_to_image",
"cost_credits": 2,
"result": null,
"error": {
"code": "generation_failed",
"message": "Generation failed."
}
}
}