API

Build with GloSnap

Generate professional AI headshots programmatically. One API call per headshot, 30-second turnaround, $1 per generation.

Get your API key View endpoints

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from the developer dashboard.

Authorization: Bearer YOUR_API_KEY

POST /api/v1/generate

Upload a photo and style to generate a headshot. Returns a generation ID for polling.

Request

curl -X POST https://glosnap.com/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "style=linkedin"

Response

{
  "id": "gen_abc123",
  "status": "processing",
  "style": "linkedin",
  "created_at": "2026-05-14T12:00:00Z"
}

GET /api/v1/generations/:id

Check the status of a generation. Poll every 3 seconds until status is 'complete'.

Request

curl https://glosnap.com/api/v1/generations/gen_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "gen_abc123",
  "status": "complete",
  "style": "linkedin",
  "image_url": "https://cdn.glosnap.com/...",
  "created_at": "2026-05-14T12:00:00Z"
}

GET /api/v1/credits

Check your current credit balance.

Request

curl https://glosnap.com/api/v1/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "balance": 27,
  "used": 3
}

GET /api/v1/styles

List all available headshot styles with names and descriptions.

Request

curl https://glosnap.com/api/v1/styles \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "styles": [
    { "id": "linkedin", "name": "LinkedIn", "desc": "Neutral gray" },
    { "id": "studio", "name": "Ring Light", "desc": "Intense gaze" },
    ...
  ]
}

Rate limits

Generate: 10 requests per minute per API key
Read endpoints: 60 requests per minute per API key
File size: 10 MB max per upload (JPG or PNG)