API & MCP
Everything a person can do on Exposure Fusion (Blend Bracketed Photos), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://luminaexposurefusion.usefulweb.app/api/v1/calculate– run Exposure Fusion (Blend Bracketed Photos)GET https://luminaexposurefusion.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Exposure Fusion (Blend Bracketed Photos)
Upload a ZIP of 2–5 bracketed photos of the same scene. The photos are aligned automatically and blended with Mertens exposure fusion: every pixel is weighted by contrast, saturation and good exposure, and a Laplacian pyramid hides the seams. No HDR file or tone mapping is needed, and the result is an ordinary 8-bit PNG. Photo Lab in Lumina runs the same engine on your device for larger photos.
| Field | Type | Default | Description |
|---|---|---|---|
images (required) | file | — | ZIP of 2–5 photos (PNG, JPEG or WebP; 12 megapixels together). All photos must have the same size. ZIP order is kept; the middle photo is the alignment reference. |
align | boolean | true | Align the photos (shift, rotation and scale) |
crop | boolean | true | Crop to the area every photo covers |
model | select (similarity, affine) | "similarity" | Alignment transform |
contrast | number | 1 | Contrast weight (exponent). 0 ignores local contrast; higher values prefer detailed areas. |
saturation | number | 1 | Saturation weight (exponent). 0 ignores colour saturation; higher values prefer vivid pixels. |
exposure | number | 1 | Well-exposedness weight (exponent). 0 ignores brightness; higher values prefer pixels near mid-grey. |
sigma | number | 0.2 | Well-exposedness width (σ). Smaller values accept a narrower band around mid-grey (0.5). |
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://luminaexposurefusion.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
lumina_exposure_fusion - Local stdio connector:
node src/mcp-stdio.ts --tool=lumina-exposure-fusion
{
"mcpServers": {
"lumina-exposure-fusion": { "type": "http", "url": "https://luminaexposurefusion.usefulweb.app/mcp" }
}
}