Reluminas API

Authentication

Public endpoints do not require auth. Private data endpoints require `DATA_API_KEY` in either `x-data-api-key` or `Authorization: Bearer ...`.

POST /api/enhance

Enhances a single photo. Send multipart form-data with at least `image`.

curl -X POST "https://reluminas.com/api/enhance" \
  -F "image=@/path/to/living-room.jpg" \
  -F "tier=preview" \
  -F "mode=flambient" \
  -F "jobId=job-123456789abc" \
  -F "skyPreference=clear_blue" \
  -F "fixGeometry=false" \
  -F "isTwilight=false"

POST /api/inspect

Runs pre-inspector analysis to route prompt fragments before enhancement.

curl -X POST "https://reluminas.com/api/inspect" \
  -F "image=@/path/to/photo.jpg" \
  -F "visitorId=anon-1234"

POST /api/enhance/revise

Runs a targeted masked fix for one generated image region (inpainting-style revision).

curl -X POST "https://reluminas.com/api/enhance/revise" \
  -F "image=@/path/to/enhanced.jpg" \
  -F "mask=@/path/to/mask.png" \
  -F "instruction=keep the original white desk color and texture"

GET /api/data/stats (private)

Aggregated usage and quality routing metrics for internal dashboards and automation.

curl "https://reluminas.com/api/data/stats?from=2026-01-01T00:00:00Z&to=2026-02-01T00:00:00Z" \
  -H "x-data-api-key: YOUR_DATA_API_KEY"

GET /api/data/runs (private)

Paginated run metadata for QA review and error analysis.

curl "https://reluminas.com/api/data/runs?limit=50&status=success" \
  -H "Authorization: Bearer YOUR_DATA_API_KEY"

GET /api/public/reports/lighting

Public aggregate dataset used by the lighting report page.

curl "https://reluminas.com/api/public/reports/lighting"

Operational Limits