Skip to main content
GET
Retrieve a generation
Poll this endpoint to track status when not using webhooks. Recommended cadence: every 1–2 seconds, with a sensible overall timeout (most renders finish within ~30s). When the render finishes, status transitions to complete (with imageUrl and imageVariants) or failed (with error). imageVariants exposes resized, CDN-cached versions of imageUrl (list / card / detail) for surfaces where the full-resolution render is overkill — emails, lists, mobile. Names describe the intended surface, so pick by where you’re rendering, not by pixel width.

Authorizations

Authorization
string
header
required

Your Selektable API key (selektable_...), sent as Authorization: Bearer <key>.

Path Parameters

id
string
required

Response

The generation

id
string
Example:

"agen_abc123"

object
enum<string>
Available options:
generation
status
enum<string>
Available options:
processing,
complete,
failed
mode
enum<string>
Available options:
virtual-try-on,
room-visualizer
imageSize
enum<string>
Available options:
1K,
2K,
4K
imageUrl
string<uri> | null

Permanent CDN URL to the original render at the requested imageSize (1K/2K/4K). Safe to store and embed.

imageVariants
object | null

Permanent CDN URLs to resized JPEG/WebP variants of imageUrl, served by Cloudflare Image Transformations. Use a variant instead of the original when you need a smaller payload (emails, lists, mobile). null until status is complete.

products
object[]
hint
string | null
error
object | null
metadata
object | null
createdAt
string<date-time>
completedAt
string<date-time> | null