Turn Links into Art Automatically
Luman AI is a zero-touch visual generation engine designed to programmatically render premium Open Graph
(OG) social preview images and multi-image collages.
By leveraging our REST API, content creators and automated pipelines can generate cached, perfectly
cropped PNG visual assets on the fly. This completely eliminates boring, text-only social links.
🧠 Automatic Deduplication & Caching: Luman tracks image variations using a strict
parameter hash recipe. If you request an identical configuration matching an asset already stored inside
your S3 Vault, our engine serves it instantly without charging your credit balance.
Single Image Generation API
To render dynamic text overlays instantly onto branded backgrounds, query our central rendering engine
directly via a standard URL query structure.
HTTP Request
GET https://luman.ca/generate
Required & Optional Query Parameters
| Parameter |
Type |
Required |
Description |
api_key |
String |
YES |
Your unique user token found under your profile tab. |
title |
String |
YES |
The primary hook string to render. Must be URL-encoded. |
theme |
String |
Optional |
Visual theme palette: dark, light, natural,
win95.
|
font_family |
String |
Optional |
Font identifier (e.g., Montserrat-Black, Oswald-Bold). |
font_location |
String |
Optional |
Text placement pattern split by Y-X axes (e.g., middle-center). |
Programmatic Collage Generation
If you need to assemble multiple image assets (such as screenshots or graphic thumbnails) into a single
cohesive frame, route your payload directly through our multipart form endpoint.
HTTP Request
POST https://luman.ca/api/generate-collage
Multipart Form Parameters
api_key (String, Required): Explicit security key verification
mapping.images (Binary Files, Required): An array list of raw image files.
Supports up to 10 files. Individual image components must remain under 512KB.collage_style (String): Layout orientation mechanics. Options are
grid or pile (scattered placement matching a random anti-aliased rotation
scheme).
prevent_overlap (Boolean, Default: true): Restricts randomized images
from occupying greater than 40% shared layout space.
Response Status Codes
Our gateway responds with specific HTTP status codes to keep your custom software integrations clean:
200 OK: Returns the raw image/png data
stream immediately.401 Unauthorized: Malformed or missing API security parameters.402 Payment Required: Insufficient credit availability.403 Forbidden: Invalid API key or request triggered domain protection locks.413 Payload Too Large: Image component file uploaded past the strict 512KB limit.