Overview
The browser texture generators (PBR map generation, normal maps, noise, gradients, etc.) run client-side. The API covers the server-side parts: seamless processing and format export.
| Operation | Endpoint | Auth |
|---|---|---|
| Make seamless | POST /api/texture/seamless | Required |
| Export seamless result | POST /api/texture/seamless/export | Required |
| Convert image to PNG | POST /api/texture/to-png | Optional |
| Channel-pack export | POST /api/texture/channel-pack/export | Required |
| Generic texture export | POST /api/texture/export | Required |
| Resize + export | POST /api/texture/resize/export | Required |
Make a texture seamless
POST
/api/texture/seamless
Auth required
Processes an image so it tiles seamlessly, returning a PNG. Seam quality is reported via response headers.
| Field | Type | Description |
|---|---|---|
| file | file * | Image to make seamless. |
| width | int | Output width (default 1024). |
| height | int | Output height (default 1024). |
Response headers include X-Seam-Score and X-Tileable. Counts as one premium operation.
Convert an image to PNG
POST
/api/texture/to-png
Optional auth
Converts tiff, tif, bmp, avif, or gif images to PNG for preview.
Export to production formats
The export endpoints re-encode a PNG (often produced by a client-side generator) into tiff, bmp, avif, or exr. All require authentication and count as a premium operation.
| Field | Type | Description |
|---|---|---|
| file | file * | Image to export. |
| format | string | One of tiff, bmp, avif, exr (default tiff). |
bash
curl -X POST https://api.geometry-labs.com/api/texture/export \
-H "Authorization: Bearer $GL_TOKEN" \
-F "file=@normal_map.png" \
-F "format=exr"Resolution limits
Maximum texture output resolution is enforced per plan. Exceeding it returns 413.
| Plan | Max texture output |
|---|---|
| Free | 2K (2048px) |
| Basic | 4K (4096px) |
| Pro | 8K (8192px) |
| Team | 8K (8192px) |