API suite

Dynamic Media API

Open Graph and social cards, QR codes, color palettes, HD favicons, avatars, badges and image inspection.

10Endpoints
2 composite$0.025 per call
8 atomic$0.005 per call
Endpoints

All 10 Dynamic Media endpoints

EndpointTierPer callDescription
/v1/brand-kit-compositecomposite$0.025Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets
/v1/dynamic-social-card-compositecomposite$0.025Generate a full social-card set (Open Graph, Twitter, square, story) as SVG with a QR code, meta tags and alt text
/v1/edge-og-svg-generatoratomic$0.005Render an Open Graph card (default 1200x630) as SVG
/v1/qr-code-svg-builderatomic$0.005Encode text or a URL as a scannable QR code SVG
/v1/color-palette-extractoratomic$0.005Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios
/v1/favicon-hd-resolveratomic$0.005Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions
/v1/avatar-initials-svgatomic$0.005Generate a deterministic initials avatar SVG with an accessible text color
/v1/badge-shield-generatoratomic$0.005Generate a status badge SVG (label | message) in flat or flat-square style
/v1/aspect-ratio-calcatomic$0.005Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets
/v1/image-meta-inspectoratomic$0.005Inspect a remote image: format, dimensions, animation, alpha, size and content type from the file header
Access

Three ways to call it

RapidAPI$0 to startSubscribe on the marketplace listing; the free Basic plan includes 15 requests per month. Open the listing.
Direct API keyX-Caelara-KeySend the key as a header on every request to https://media.caelaralabs.com. Request a key.
Keyless x402 USDC$0.005 / $0.025 on BaseAtomic / composite per call. A call without credentials returns HTTP 402 with payment terms; pay in USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base and retry with X-PAYMENT.
Model Context Protocol

Remote MCP server

Connect an MCP client over Streamable HTTP with no local install. Endpoint https://media.caelaralabs.com/mcp, listed in the Official MCP Registry as com.caelaralabs/media. initialize and tools/list work without credentials; tool calls need an API key sent as X-Caelara-Key. Keyless x402 payment applies to the direct HTTP routes, not to MCP tool calls.

{ "mcpServers": { "caelara-media": { "type": "http", "url": "https://media.caelaralabs.com/mcp", "headers": { "X-Caelara-Key": "${CAELARA_KEY}" } } } }