backgrounds

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Structure name from list_backgrounds, e.g. "wave".'}, 'format': {'enum': ['markdown', 'json'], 'type': 'string', 'description': 'markdown (default) is best for reading; json includes the JSON Schema.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['structure'], 'properties': {'seed': {'type': 'string', 'description': 'Any string. Omit for a fresh random seed (returned in the result).'}, 'brand': {'type': 'string', 'description': 'Slug of a saved brand kit (see list_brand_kits); its colours become the palette baseline.'}, 'shape': {'type': 'object', 'description': 'Structure-specific options; call describe_background for the exact keys, ranges and what they do.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': ['number', 'boolean', 'string']}}, 'width': {'type': 'integer', 'maximum': 8192, 'minimum': 1}, 'format': {'enum': ['svg', 'png'], 'type': 'string', 'description': 'png (default) returns a viewable image; svg returns the vector source.'}, 'height': {'type': 'integer', 'maximum': 8192, 'minimum': 1}, 'palette': {'type': 'object', 'properties': {'colors': {'type': 'array', 'items': {'type': 'string', 'pattern': '^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$'}, 'maxItems': 12, 'minItems': 1, 'description': 'Explicit hex colours to draw from (best for brand matching). Overrides palette/scheme.'}, 'palette': {'type': 'string', 'description': 'Id of a built-in palette from list_palettes, e.g. "underTheSea".'}, 'opaqueColors': {'type': 'boolean'}, 'primaryColor': {'type': 'string', 'pattern': '^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$'}, 'gradientColor': {'type': 'boolean', 'description': 'Gradient fills instead of flat colour.'}, 'useMultiColor': {'type': 'boolean', 'description': 'false = everything in primaryColor.'}, 'secondaryColor': {'type': 'string', 'pattern': '^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$'}, 'backgroundColor': {'type': 'string', 'pattern': '^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$'}, 'colorSchemeType': {'enum': ['Mono', 'Tetrade', 'Analogic'], 'type': 'string', 'description': 'Derive a palette from primaryColor.'}}, 'additionalProperties': False}, 'pngWidth': {'type': 'integer', 'maximum': 8192, 'minimum': 16, 'description': 'Raster width for PNG output/preview. Defaults to the render width, capped for inline previews.'}, 'structure': {'type': 'string', 'description': 'Structure name, e.g. "wave".'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tag': {'type': 'string'}, 'mood': {'type': 'string', 'description': 'A mood word, e.g. dark, playful, minimal, retro.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Free text, e.g. "calm waves" or "geometric poster".'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'type': 'string', 'description': 'Filter by a mood tag, e.g. "dark" or "pastel".'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['brief'], 'properties': {'brief': {'type': 'string', 'minLength': 2}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1}}}