1 · Quick start
One line of HTML ships an effect. No SDK, no bundler config.
<img src="https://insightsbyomkar.com/api/studio/effects/aurora?palette=nebula" alt="" />
That’s it. The edge cache serves it to everyone else on your site for a week after the first render.
2 · The contract
| Cache | Browser 1 day · CDN 7 days · immutable. Every URL is deterministic per its params — no stale invalidation needed. |
|---|---|
| CORS | Open. Origin is *. Embed from any site. |
| Content type | image/svg+xml. All effects are SVG — animation via native SMIL, noise via feTurbulence. |
| Motion | Plays inside a plain <img> — zero JavaScript runtime. Browsers honour prefers-reduced-motion on SMIL automatically. |
| Determinism | Same URL returns the same SVG byte-for-byte. Safe to hash, diff, or pin in a test fixture. |
| Versioning | Adding a param, palette, or kind is additive — never breaks. Removing one or changing semantics is a major-version bump (/v2). v1 contract is stable forever. |
| Stability SLA | Beta — 99.5% uptime. Paid pilots graduate to 99.9% with written SLA. |
| Rate limits | Open at the Vercel edge tier. Per-client keys with dedicated lanes open for pilot engagements. |
3 · Aurora
GET https://insightsbyomkar.com/api/studio/effects/aurora
Organic drifting gradient field — three layered radial gradients at independent cycles plus optional grain overlay and a ±0.5° hue wobble. Reads as atmospheric, living. Use for hero backdrops, section dividers, ambient loops.
| Param | Type | Default | Range | Note |
|---|---|---|---|---|
seed | string | aurora-default | ≤ 64 chars | Deterministic — same seed always produces the same gradient anchors + animation offsets. |
palette | enum | aurora | aurora · ember · nebula · forest · ocean · rose | Chooses the 5-stop color set. See §7 for visual reference. |
width | int | 1600 | 400 – 3840 | Clamped. |
height | int | 900 | 220 – 2160 | Clamped. |
speed | float | 1 | 0.25 – 3 | Multiplier on the 28s reference cycle. 0.25 = four times slower; 3 = three times faster. |
grain | float | 0.18 | 0 – 0.6 | Film grain alpha overlay. Set 0 for pristine gradient; 0.3+ for analog feel. |
https://insightsbyomkar.com/api/studio/effects/aurora?palette=nebula&seed=my-hero&speed=0.8
4 · Starfield
GET https://insightsbyomkar.com/api/studio/effects/starfield
Three-depth-layer parallax particle field. Four kinds trade the same three-layer scaffolding for different particle behaviors (stars twinkle, dust is static, snow falls, confetti tumbles with rotation).
| Param | Type | Default | Range | Note |
|---|---|---|---|---|
seed | string | starfield-default | ≤ 64 chars | Deterministic particle placement. |
palette | enum | aurora | 6 palettes — see §7 | Affects particle color sampling. |
kind | enum | stars | stars · dust · snow · confetti | Switches particle behavior + default styling. |
width | int | 1600 | 400 – 3840 | |
height | int | 900 | 220 – 2160 | |
density | float | 1 | 0.25 – 3 | Multiplier on particle count. 0.25 = sparse; 3 = saturated. |
speed | float | 1 | 0.25 – 3 | Only affects kinds with motion (snow, confetti). Stars twinkle at their own cadence. |
https://insightsbyomkar.com/api/studio/effects/starfield?kind=snow&density=1.4&palette=ocean
5 · Grain
GET https://insightsbyomkar.com/api/studio/effects/grain
Transparent-background overlay designed to composite with mix-blend-mode: overlay. Three kinds: film (soft fractal grain), paper (higher octaves, warmer bias), halftone (discrete dot matrix).
| Param | Type | Default | Range | Note |
|---|---|---|---|---|
seed | string | grain-default | ≤ 64 chars | Shifts noise pattern + halftone phase so stacked grains don't stripe. |
kind | enum | film | film · paper · halftone | |
width | int | 1600 | 200 – 3840 | |
height | int | 900 | 200 – 2160 | |
intensity | float | 0.25 | 0.02 – 0.9 | Alpha multiplier. 0.1 for subtle film; 0.5+ for heavy paper. |
tone | enum | neutral | neutral · warm · cool | Biases the final color matrix. Warm = amber-forward; cool = blue-forward. |
<img src="https://insightsbyomkar.com/api/studio/effects/grain?intensity=0.3&tone=warm"
style="mix-blend-mode:overlay;position:absolute;inset:0" />6 · Glow
GET https://insightsbyomkar.com/api/studio/effects/glow
Radial burst with optional chromatic aberration and slow pulse. Use for hero centerpieces, button auras, section keystones.
| Param | Type | Default | Range | Note |
|---|---|---|---|---|
palette | enum | aurora | 6 palettes — see §7 | Controls core gradient colors. |
width | int | 1200 | 240 – 3840 | |
height | int | 800 | 240 – 2160 | |
intensity | float | 0.85 | 0.2 – 1.2 | Multiplier on the central glow opacity. |
chromatic | float | 0.35 | 0 – 1 | Red + blue offset layers at screen blend. 0 = pure glow; 1 = heavy aberration. |
pulse | bool | true | true · false | Slow 7-second opacity breathing loop. |
https://insightsbyomkar.com/api/studio/effects/glow?palette=ember&chromatic=0.6&pulse=true
7 · Palette catalog
Six curated 5-stop palettes. Each one is a named mood, not a named vertical — use the one that matches your section’s atmosphere.
aurora
ember
nebula
forest
ocean
rose
8 · Integration patterns
As an image element
<img src="https://insightsbyomkar.com/api/studio/effects/aurora?palette=nebula" alt="" style="position:absolute;inset:0;width:100%;height:100%;object-fit:cover;z-index:0" />
As a CSS background
.hero {
background-image: url('https://insightsbyomkar.com/api/studio/effects/aurora?palette=ocean');
background-size: cover;
background-position: center;
}As a layered composition (aurora + grain)
<div class="hero" style="position:relative;height:100vh">
<img src="https://insightsbyomkar.com/api/studio/effects/aurora?palette=rose"
alt="" style="position:absolute;inset:0;width:100%;height:100%;object-fit:cover;z-index:0" />
<img src="https://insightsbyomkar.com/api/studio/effects/grain?intensity=0.3"
alt="" style="position:absolute;inset:0;width:100%;height:100%;object-fit:cover;
mix-blend-mode:overlay;z-index:1;pointer-events:none" />
<div class="content" style="position:relative;z-index:2">
<h1>Your copy here.</h1>
</div>
</div>Next.js / React
// No component library required — it's an <img>.
// If you want ergonomic URL building, this 10-line helper does it:
export function vsUrl(effect: string, params: Record<string, string|number|boolean> = {}) {
const q = new URLSearchParams(
Object.fromEntries(
Object.entries(params).map(([k, v]) => [k, String(v)])
)
);
return `https://insightsbyomkar.com/api/studio/effects/${effect}?${q.toString()}`;
}
// Usage:
<img src={vsUrl("aurora", { palette: "nebula", seed: "my-hero" })} alt="" />9 · Errors
Every effect endpoint validates its params. Unknown or out-of-range values return a structured 400 JSON response listing the allowed set.
GET /api/studio/effects/aurora?palette=mint
→ 400 { "error": "Unknown palette 'mint'. Available: aurora, ember, nebula, forest, ocean, rose", "available": ["aurora", ...] }Clamped numeric params (width, height, speed, density, intensity, chromatic, grain) never 400 — they silently clamp to their min/max. This is deliberate: runtime integration code should never fail because someone passed width=10000.
10 · Companion sublayers
- Illustration API — 84 SVG slugs (UI icons, astrology glyphs, aspect patterns, ornaments, animated scenes) + sprite sheet + palette API + catalog JSON.
- Character API — parametric SVG for posable illustrated characters. Lucky ships with 18 pose+mood combinations; commissions open for new characters.
- Motion Engine — tween() composers, sequence / parallel / stagger primitives, framework-agnostic.
- 3D via Canvas 2D— hand-rolled isometric + perspective projection, under 10 KB vs Three.js’s 150 KB.
All companion sublayers share the same URL contract, cache policy, CORS stance, and palette catalog as the effects above.