{"openapi":"3.0.3","info":{"title":"Caelara Labs Dynamic Media Suite","description":"Zero-scrape dynamic media for agents and builders, rendered at the edge: Open Graph SVG cards, QR codes, color palettes, high-resolution favicon resolution, initials avatars, shield badges, aspect-ratio math and image metadata inspection, plus composite brand-kit and social-card generators.","version":"1.0.0","contact":{"email":"ops@caelaralabs.com","url":"https://caelaralabs.com"}},"servers":[{"url":"https://media.caelaralabs.com"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Proxy-Secret"},"CaelaraKey":{"type":"apiKey","in":"header","name":"X-Caelara-Key"},"x402USDC":{"type":"http","scheme":"bearer","description":"x402 USDC payment on Base network"}}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/brand-kit-composite":{"get":{"summary":"Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"domain","in":"query","required":true,"description":"Brand domain, e.g. stripe.com","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Brand display name (default derived from the domain)","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"Brand color override (hex, with or without #)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/dynamic-social-card-composite":{"get":{"summary":"Generate a full social-card set (Open Graph, Twitter, square, story) as SVG with a QR code, meta tags and alt text","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"title","in":"query","required":true,"description":"Card headline","schema":{"type":"string"}},{"name":"subtitle","in":"query","required":false,"description":"Supporting line","schema":{"type":"string"}},{"name":"brand","in":"query","required":false,"description":"Brand label shown on the card","schema":{"type":"string"}},{"name":"url","in":"query","required":false,"description":"Destination URL; adds a QR code and domain label","schema":{"type":"string"}},{"name":"theme","in":"query","required":false,"description":"dark (default) or light","schema":{"type":"string"}},{"name":"accent","in":"query","required":false,"description":"Accent color (hex, with or without #)","schema":{"type":"string"}},{"name":"bg","in":"query","required":false,"description":"Background color (hex, with or without #)","schema":{"type":"string"}},{"name":"fg","in":"query","required":false,"description":"Text color (hex, with or without #)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/edge-og-svg-generator":{"get":{"summary":"Render an Open Graph card (default 1200x630) as SVG","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"title","in":"query","required":true,"description":"Headline","schema":{"type":"string"}},{"name":"subtitle","in":"query","required":false,"description":"Supporting line","schema":{"type":"string"}},{"name":"brand","in":"query","required":false,"description":"Brand label","schema":{"type":"string"}},{"name":"theme","in":"query","required":false,"description":"dark (default) or light","schema":{"type":"string"}},{"name":"bg","in":"query","required":false,"description":"Background color (hex, with or without #)","schema":{"type":"string"}},{"name":"fg","in":"query","required":false,"description":"Text color (hex, with or without #)","schema":{"type":"string"}},{"name":"accent","in":"query","required":false,"description":"Accent color (hex, with or without #)","schema":{"type":"string"}},{"name":"width","in":"query","required":false,"description":"Width in px (200-4000, default 1200)","schema":{"type":"integer"}},{"name":"height","in":"query","required":false,"description":"Height in px (200-4000, default 630)","schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"description":"json (default, includes svg + data URI) or svg (raw image/svg+xml)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/qr-code-svg-builder":{"get":{"summary":"Encode text or a URL as a scannable QR code SVG","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"text","in":"query","required":true,"description":"Text or URL to encode (max 1000 bytes)","schema":{"type":"string"}},{"name":"ecc","in":"query","required":false,"description":"Error correction: L, M (default), Q or H","schema":{"type":"string"}},{"name":"size","in":"query","required":false,"description":"Rendered size in px (64-2048, default 256)","schema":{"type":"integer"}},{"name":"margin","in":"query","required":false,"description":"Quiet zone in modules (0-16, default 4)","schema":{"type":"integer"}},{"name":"fg","in":"query","required":false,"description":"Module color (hex, with or without #)","schema":{"type":"string"}},{"name":"bg","in":"query","required":false,"description":"Background color (hex, with or without #)","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"json (default, includes svg + data URI) or svg (raw image/svg+xml)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/color-palette-extractor":{"get":{"summary":"Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":false,"description":"Image URL (PNG or SVG are pixel/markup sampled)","schema":{"type":"string"}},{"name":"colors","in":"query","required":false,"description":"Comma list of hex colors to analyze instead of an image","schema":{"type":"string"}},{"name":"count","in":"query","required":false,"description":"Number of colors (1-12, default 5)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/favicon-hd-resolver":{"get":{"summary":"Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain or URL, e.g. github.com","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/avatar-initials-svg":{"get":{"summary":"Generate a deterministic initials avatar SVG with an accessible text color","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Person or company name","schema":{"type":"string"}},{"name":"size","in":"query","required":false,"description":"Size in px (24-1024, default 128)","schema":{"type":"integer"}},{"name":"shape","in":"query","required":false,"description":"circle (default), rounded or square","schema":{"type":"string"}},{"name":"bg","in":"query","required":false,"description":"Background color (default derived from the name) (hex, with or without #)","schema":{"type":"string"}},{"name":"fg","in":"query","required":false,"description":"Text color (default chosen for contrast) (hex, with or without #)","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"json (default, includes svg + data URI) or svg (raw image/svg+xml)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/badge-shield-generator":{"get":{"summary":"Generate a status badge SVG (label | message) in flat or flat-square style","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"label","in":"query","required":true,"description":"Left label","schema":{"type":"string"}},{"name":"message","in":"query","required":true,"description":"Right message","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"Message background color (default 2ea44f) (hex, with or without #)","schema":{"type":"string"}},{"name":"label_color","in":"query","required":false,"description":"Label background color (default 555555) (hex, with or without #)","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"flat (default) or flat-square","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"json (default, includes svg + data URI) or svg (raw image/svg+xml)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/aspect-ratio-calc":{"get":{"summary":"Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"width","in":"query","required":true,"description":"Width","schema":{"type":"integer"}},{"name":"height","in":"query","required":true,"description":"Height","schema":{"type":"integer"}},{"name":"target_width","in":"query","required":false,"description":"Scale to this width","schema":{"type":"integer"}},{"name":"target_height","in":"query","required":false,"description":"Scale to this height","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/image-meta-inspector":{"get":{"summary":"Inspect a remote image: format, dimensions, animation, alpha, size and content type from the file header","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Image URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}}}}