Get Image

Retrieve metadata for a single generated image by its ID. Returns a 404 if the image does not exist or belongs to a different user.

Endpoint

GET /images/:id

Path parameters

Parameter	Type	Required	Description
id	string	Yes	The image ID (e.g. "img_a1b2c3...") returned from /try_on_outfit or /style_me

Request

No request body. Authentication via X-API-Key header.

curl https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/images/img_a1b2c3d4e5f6a1b2c3d4e5f6 \
  -H "X-API-Key: YOUR_API_KEY"

Response

Field	Type	Description
image_id	string	Unique image identifier
image_url	string	Direct URL to the image
mime_type	string	Image MIME type (e.g. "image/jpeg")
category	string	Image category ("try-on", "style-me")
endpoint	string	Endpoint that generated this image
created_at	string	ISO 8601 creation timestamp
persistent	boolean	Whether the image is stored permanently

Example response

{
  "image_id": "img_a1b2c3d4e5f6a1b2c3d4e5f6",
  "image_url": "https://superstyle-user-images.s3.us-east-1.amazonaws.com/usr_123/try-on/20260228T153000Z_a1b2c3.jpg",
  "mime_type": "image/jpeg",
  "category": "try-on",
  "endpoint": "/try_on_outfit",
  "created_at": "2026-02-28T15:30:00.000Z",
  "persistent": true
}

Error responses

Image not found

{
  "error": "Image not found"
}

Returned with status 404 when the image ID does not exist or belongs to a different user.

Notes

• This endpoint is free and unlimited — it does not count toward rate limits
• Image ownership is enforced — you can only retrieve images generated by your own API keys
• Non-persistent images may be deleted after 24 hours, in which case the image_url will no longer resolve