Overview
| Tool | Endpoint | Response |
|---|---|---|
| Convert HDRI | POST /api/hdri/convert | ZIP (cubemap) or PNG |
| IBL filter | POST /api/hdri/filter | ZIP (mipmaps) |
| Lighting setup | POST /api/hdri/lighting | GLTF |
| Light probe | POST /api/hdri/probe | JSON |
Convert HDRI
POST
/api/hdri/convert
Auth required
Converts an HDRI image. When targeting cubemap, returns a zip of face images; otherwise returns a PNG.
| Field | Type | Description |
|---|---|---|
| file | file * | HDRI image. |
| sourceFormat | string | hdr or exr (default hdr). |
| targetFormat | string | cubemap or other (default cubemap). |
| faceSize | int | Cubemap face size (default 512). |
IBL filter
POST
/api/hdri/filter
Auth required
Generates IBL mipmap levels, returned as a zip.
| Field | Type | Description |
|---|---|---|
| file | file * | HDRI image. |
| sourceFormat | string | hdr or exr (default hdr). |
| mipLevels | array (JSON) | Mipmap sizes, e.g. [256, 128, 64, 32]. |
Lighting setup
POST
/api/hdri/lighting
Auth required
Generates a punctual-lights GLTF rig. No file upload required.
| Field | Type | Description |
|---|---|---|
| setupType | string | Lighting setup (default three-point). |
| keyIntensity | float | Key light intensity. |
| fillIntensity | float | Fill light intensity. |
| rimIntensity | float | Rim light intensity. |
Light probe
POST
/api/hdri/probe
Auth required
Bakes light-probe data from a model and an HDRI. Returns JSON.
| Field | Type | Description |
|---|---|---|
| model | file * | 3D model. |
| hdri | file * | HDRI environment. |
| inputFormat | string | Model format (default glb). |
| probeCount | int | Number of probes (default 16). |