Skip to main content
Base URL: https://platform.runblob.io

​
GET /v1/gemini/generations/

Retrieve the status and result of an image generation task.
​
task_uuid
string
required
The UUID returned from the generate endpoint
curl https://platform.runblob.io/v1/gemini/generations/ffd473d5-5bef-4e14-bf22-8d559be3c19f \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (Pending/Processing)

{
  "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "processing",
  "prompt": "A cute orange cat sitting on a windowsill",
  "result_image_url": null,
  "message": null
}

​
Response (Completed)

{
  "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "completed",
  "prompt": "A cute orange cat sitting on a windowsill",
  "result_image_url": "https://storage.runblob.io/nanobanana/outputs/2025/12/ffd473d5-5bef-4e14-bf22-8d559be3c19f.png",
  "message": null
}

​
Response (Failed)

{
  "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "failed",
  "prompt": "A cute orange cat sitting on a windowsill",
  "result_image_url": null,
  "message": "MODERATION_FAILED"
}
​
task_uuid
string
UUID of the generation task
​
status
string
Current status: "pending", "processing", "completed", or "failed"
​
prompt
string
Original prompt used for generation
​
result_image_url
string
URL of the generated image (only when status is "completed")
​
message
string
Error code if status is "failed", otherwise null

​
Status Values

StatusDescription
pendingTask is queued, waiting to be processed
processingGeneration is in progress
completedImage is ready, check result_image_url
failedGeneration failed, check message for error code

​
List Generations

​
GET /v1/gemini/generations

Retrieve a list of your recent generations.
​
limit
number
default:"50"
Maximum number of results (1-100)
​
offset
number
default:"0"
Number of results to skip (pagination)
curl "https://platform.runblob.io/v1/gemini/generations?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

[
  {
    "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
    "status": "completed",
    "prompt": "A cute orange cat...",
    "result_image_url": "https://storage.runblob.io/...",
    "message": null
  },
  {
    "task_uuid": "abc123d5-5bef-4e14-bf22-8d559be3c19f",
    "status": "failed",
    "prompt": "Another prompt...",
    "result_image_url": null,
    "message": "API_ERROR"
  }
]