Image Generation (Status)

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

This endpoint is implemented by the UnderSky Rust gateway. Availability depends on the configured upstream provider and media storage.

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

Endpoint

GET https://api.undersky.ai/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.undersky.ai/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://cdn.example.com/images/generated/abc123?token=example"
      }
    ]
  }
}

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.