Image library

List images

GET https://api-design.prosecaptain.com/api/images?limit=50&offset=0

Returns images from your library, newest first. limit up to 100. The designSessionId parameter narrows the list to one session.

{
  "success": true,
  "count": 1,
  "total_count": 42,
  "images": [
    { "id": "b1e2…", "filename": "image-….jpeg", "url": "https://api.paqshot.com/assets/…", "timestamp": "2026-10-19T09:00:00Z", "params": { "sceneType": "product_packshot", "aspectRatio": "1:1" } }
  ]
}

Session state

GET https://api-design.prosecaptain.com/api/design-sessions/SESSION_ID/state

Returns the image versions in a design session.

Rate an image

POST https://api-design.prosecaptain.com/api/images/IMAGE_ID/rating

{ "rating": 5 }

A rating from 1 to 5 helps us improve generation quality.

Reference data

Endpoint	Returns
GET /api/templates	Infographic templates and your workspace templates
GET /api/presets	Scene presets
GET /api/locations	Available lifestyle locations