Image Generation (Status)

Reference for GET /v1/images/generations/:id, including task status, generated image records, timeout handling, and ownership checks.

Check the status of an image generation task and retrieve the generated images once complete.

Endpoint

GET https://api.leaper.one/v1/images/generations/:id

Parameters

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

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "images": [
      {
        "id": "image-abc123",
        "url": "https://s3.bitiful.net/leaperone/images/generated/abc123?X-Amz-Expires=3600&..."
      }
    ]
  }
}

Status Values

Status	Description
`reserved`	Credits reserved; waiting for a current worker to claim the task
`pending`	Task is queued and waiting to start
`processing`	Image generation is in progress
`uploading`	Generated images are being uploaded to storage
`partial`	The task finished with fewer images than requested; returned images are ready
`completed`	All images are ready for download
`failed`	Generation failed; the API returns a safe message while raw provider details remain internal

Notes

Image URLs are signed on each status request and expire after 1 hour. Poll again to receive a fresh URL.
Tasks older than 30 days are deleted. Requesting a deleted task returns 410 Gone.