Raw schema
{
"type": "object",
"properties": {
"seed": {
"default": 1372713745,
"description": "Composition seed (integer). Reuse it to keep the layout while changing colors or finish; omit for a random one.",
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"placement": {
"default": "random",
"description": "Where color points sit: 'center' for a calm middle, 'random' for an off-center composition.",
"type": "string",
"enum": [
"center",
"random"
]
},
"backgroundColor": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Base color as #RRGGBB. Dark values give the premium look; light ones give pastels."
},
"colors": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"description": "1β8 gradient colors as #RRGGBB. Three or four is typical. Use saturated mid-tones; muddy or near-grey colors come out dull."
},
"blur": {
"default": 800,
"description": "Softness of the color fields in export pixels, 0β1000. Keep 700β900 for the soft mesh look; below 500 the blobs show hard edges.",
"type": "number",
"minimum": 0,
"maximum": 1000
},
"grain": {
"default": 0.2,
"description": "Film-grain strength 0β0.8. 0.2 is subtle, 0.3+ is visibly textured. Grain also hides banding.",
"type": "number",
"minimum": 0,
"maximum": 0.8
},
"contrast": {
"default": 130,
"description": "Contrast 50β200 (%). 100 is flat; 130 is the studio default and what makes colors read. Don't lower it for 'subtle', lower grain instead.",
"type": "number",
"minimum": 50,
"maximum": 200
},
"saturation": {
"default": 110,
"description": "Saturation 50β200 (%). 100 is neutral; 110β120 keeps the palette alive against grain and dither, which both mute it.",
"type": "number",
"minimum": 50,
"maximum": 200
},
"style": {
"default": "blobs",
"description": "'blobs' (soft overlapping fields), 'stripes' (flowing silk fibers), 'clouds' (billowing volumes) or 'rays' (soft god rays fanning from above).",
"type": "string",
"enum": [
"blobs",
"stripes",
"clouds",
"rays"
]
},
"fiberDensity": {
"default": 1,
"description": "Stripes only: how many fibers, 0β2 (1 = designed look).",
"type": "number",
"minimum": 0,
"maximum": 2
},
"waviness": {
"default": 1,
"description": "Stripes only: how much the fibers bend, 0β2.",
"type": "number",
"minimum": 0,
"maximum": 2
},
"sheen": {
"default": 0.2,
"description": "Stripes only: highlight along the fibers, 0β2. 0.2 is the default.",
"type": "number",
"minimum": 0,
"maximum": 2
},
"coverage": {
"default": 1,
"description": "Clouds only: how much of the frame the clouds fill, 0β2.",
"type": "number",
"minimum": 0,
"maximum": 2
},
"softness": {
"default": 1,
"description": "Clouds only: edge softness, 0β2.",
"type": "number",
"minimum": 0,
"maximum": 2
},
"detail": {
"default": 1,
"description": "Clouds only: fine structure, 0β2.",
"type": "number",
"minimum": 0,
"maximum": 2
},
"effect": {
"default": "none",
"description": "Finish over the gradient: 'none', 'pixel' (dot matrix) or 'dither' (palette-quantized cells and glyphs). Pixel and dither preview free and export on Pro.",
"type": "string",
"enum": [
"none",
"pixel",
"dither"
]
},
"effectSize": {
"default": 24,
"description": "Finish cell size in export pixels, 8β64. 24 default; 40+ reads as deliberate at feed size.",
"type": "number",
"minimum": 8,
"maximum": 64
},
"effectStrength": {
"default": 1,
"description": "Finish density 0β2 (dot size for pixel, glyph density for dither).",
"type": "number",
"minimum": 0,
"maximum": 2
},
"effectOpacity": {
"default": 1,
"description": "0β1 blend of the finish over the smooth gradient; 1 replaces it, 0.5 shows both.",
"type": "number",
"minimum": 0,
"maximum": 1
},
"ditherChars": {
"default": "",
"description": "Dither only: characters to draw instead of the built-in symbols, e.g. '01' or '+-'. Up to 16.",
"type": "string",
"maxLength": 32
},
"ditherGlyphsOnly": {
"default": false,
"description": "Dither only: true draws only the characters over the smooth gradient (no cell quantizing).",
"type": "boolean"
},
"overlay": {
"default": "none",
"description": "'none' or 'shapes' for concentric outlines of one shape radiating from a point.",
"type": "string",
"enum": [
"none",
"shapes"
]
},
"overlayShape": {
"default": "circle",
"description": "Overlay shape: circle, square, rounded, squircle, diamond, triangle, hexagon, star, flower, seal, heart, or 'custom' with overlaySvg.",
"type": "string",
"enum": [
"circle",
"square",
"rounded",
"squircle",
"diamond",
"triangle",
"hexagon",
"star",
"flower",
"seal",
"heart",
"custom"
]
},
"overlayOpacity": {
"default": 0.4,
"description": "Overlay outline opacity 0β1. 0.15β0.4 stays a texture; higher becomes a graphic.",
"type": "number",
"minimum": 0,
"maximum": 1
},
"overlaySize": {
"default": 800,
"description": "Base shape size in export pixels, 100β3000.",
"type": "number",
"minimum": 100,
"maximum": 3000
},
"overlaySpacing": {
"default": 60,
"description": "Gap between rings in export pixels, 10β200.",
"type": "number",
"minimum": 10,
"maximum": 200
},
"overlayStroke": {
"default": 3,
"description": "Ring stroke width in export pixels, 1β20.",
"type": "number",
"minimum": 1,
"maximum": 20
},
"overlayCenter": {
"description": "Ring origin as [x, y] fractions of the frame, e.g. [0.88, 0.18] for top-right; omit for a seeded point.",
"type": "array",
"prefixItems": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "number",
"minimum": 0,
"maximum": 1
}
]
},
"overlayClip": {
"default": false,
"description": "Clip instead of rings: the whole gradient is drawn inside the overlay shape, on overlayClipBackground",
"type": "boolean"
},
"overlayClipBackground": {
"default": "#F6F5F1",
"description": "Hex color around a clipped shape (off-white by default)",
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"overlayPath": {
"description": "Set by the server from overlaySvg; do not pass directly.",
"type": "object",
"properties": {
"d": {
"type": "string",
"minLength": 1,
"maxLength": 70000,
"pattern": "^[MmZzLlHhVvCcSsQqTtAa0-9eE.,\\s+-]+$"
},
"box": {
"type": "array",
"prefixItems": [
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "number",
"exclusiveMinimum": 0
}
]
},
"parts": {
"maxItems": 600,
"type": "array",
"items": {
"type": "object",
"properties": {
"d": {
"type": "string",
"minLength": 1,
"maxLength": 70000,
"pattern": "^[MmZzLlHhVvCcSsQqTtAa0-9eE.,\\s+-]+$"
},
"m": {
"type": "array",
"prefixItems": [
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number"
}
]
},
"rule": {
"type": "string",
"const": "evenodd"
},
"knock": {
"type": "boolean",
"const": true
},
"stroke": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000
}
},
"required": [
"d"
],
"additionalProperties": false
}
}
},
"required": [
"d",
"box"
],
"additionalProperties": false
},
"aspectRatio": {
"default": "16:9",
"description": "Frame shape for a preview, e.g. '16:9' hero, '1.91:1' OG image, '4:5' LinkedIn post, '9:16' story. Ignored when size is given.",
"type": "string",
"enum": [
"16:9",
"16:10",
"21:9",
"1.91:1",
"5:2",
"3:1",
"4:1",
"1:1",
"4:3",
"3:2",
"9:16",
"3:4",
"4:5",
"5:3"
]
},
"size": {
"description": "Exact export size in pixels [width, height], each 64β3840, e.g. [1200, 630]. Omit for a free 960px preview (no key needed); giving a size needs an API key and uses one monthly export.",
"type": "array",
"prefixItems": [
{
"type": "integer",
"minimum": 64,
"maximum": 3840
},
{
"type": "integer",
"minimum": 64,
"maximum": 3840
}
]
},
"overlaySvg": {
"description": "Raw text of an SVG (a logo) to draw as concentric outlines; sets overlay to shapes/custom. Up to 64 KB.",
"type": "string",
"maxLength": 64000
},
"format": {
"default": "jpeg",
"description": "Export file format. JPEG is ~8x smaller; grain makes PNGs large.",
"type": "string",
"enum": [
"jpeg",
"png"
]
}
},
"required": [
"backgroundColor",
"colors"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}