Image Generation (Status)
GET /v1/images/generations/:id
Check the status of an image generation task and retrieve the generated images once complete.
Endpoint
GET https://api.leaper.one/v1/images/generations/:idParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (path) | Yes | UUID of the image generation task, returned by the Create endpoint |
Request
curl https://api.leaper.one/v1/images/generations/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer sk-your-api-key"Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"images": [
{
"url": "https://storage.leaper.one/images/a1b2c3d4.png"
}
]
}Status Values
| Status | Description |
|---|---|
pending | Task is queued and waiting to start |
processing | Image generation is in progress |
uploading | Generated images are being uploaded to storage |
partial | Some images are ready; others are still processing |
completed | All images are ready for download |
failed | Generation failed; check error details in the response |
Notes
- Image URLs are temporary and expire after 1 hour. Download or cache them promptly.
- Tasks older than 30 days are deleted. Requesting a deleted task returns 410 Gone.