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
| Endpoint | Tier | Per call | Description |
|---|---|---|---|
/v1/brand-kit-composite | composite | $0.025 | Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets |
/v1/dynamic-social-card-composite | composite | $0.025 | Generate 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-generator | atomic | $0.005 | Render an Open Graph card (default 1200x630) as SVG |
/v1/qr-code-svg-builder | atomic | $0.005 | Encode text or a URL as a scannable QR code SVG |
/v1/color-palette-extractor | atomic | $0.005 | Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios |
/v1/favicon-hd-resolver | atomic | $0.005 | Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions |
/v1/avatar-initials-svg | atomic | $0.005 | Generate a deterministic initials avatar SVG with an accessible text color |
/v1/badge-shield-generator | atomic | $0.005 | Generate a status badge SVG (label | message) in flat or flat-square style |
/v1/aspect-ratio-calc | atomic | $0.005 | Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets |
/v1/image-meta-inspector | atomic | $0.005 | Inspect 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}"
}
}
}
}