Home / API docs / Logo Generator API
Design & Assets

Logo Generator API

POST /api/logo/generate $0.02 per call USDC on Base · x402

Logo generator: POST a company name (+ optional tagline), an icon (search query or exact Font Awesome name), 1-3 brand colors (hex or CSS names), a mark shape (squircle/rounded/circle/square/transparent) and a layout — icon above/below the name (square logo) or beside it (wide lockup) — and get a finished logo as SVG + PNG. Text set in one of six curated open-license fonts (named or randomly rotated), rendered as vector paths.

Parameters

NameInDescription
namebodyrequiredCompany/product wordmark text (required, max 40 chars)
taglinebodyOptional tagline under the name (max 60 chars)
querybodyIcon search text — best Font Awesome match becomes the mark
iconbodyExact Font Awesome icon name (skips search)
stylebodyIcon style: solid (default), regular, or brands
layoutbodyMark position vs text: bottom (mark above name, square — default), top (name above mark, square), right or left (side-by-side wide lockup)
shapebodyMark background: squircle (default), rounded, circle, square, transparent
colorsbody1-3 colors, hex or CSS names: [0] brand (mark bg, or glyph if transparent), [1] gradient partner, [2] text color (default: brand)
fontbodymontserrat, playfair, space-grotesk, bebas, poppins, dm-serif — omit for random
fgbodyGlyph color override (default white on filled shapes)
bgbodyCanvas background color (default transparent)

Example request

curl -X POST "https://api.webbersites.com/api/logo/generate" \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind","tagline":"Data for autonomous agents","query":"rocket","layout":"bottom","shape":"squircle","colors":["#ff6b35","#b23b18"],"font":"montserrat"}'
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "name": "Northwind",
    "icon": {
        "name": "rocket",
        "style": "solid"
    },
    "font": {
        "key": "montserrat",
        "label": "Montserrat Bold"
    },
    "layout": "bottom",
    "width": 1024,
    "height": 1024,
    "svg": "<svg …>",
    "png_base64": "iVBOR…"
}
MCP tool: post_logo_generate — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.