# Webbersites Icon Generator

> Webbersites Icon Generator is a paid API for AI agents from api.webbersites.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Generates app-icon-ready SVG and PNG assets using a Font Awesome Free glyph on a customizable background shape and color

## Facts

- Endpoint: POST https://api.webbersites.com/api/icon/generate
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/webbersites-icon-generator-6fb27a63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yrfQ8PdA2e1X-sG6UitUI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability webbersites-icon-generator-6fb27a63 -d '<json body>'
```

Example prompt: Generate me an iOS-ready app icon using a Font Awesome 'rocket' icon — white glyph on a purple-to-blue gradient squircle background, 1024px, with the solid style and default padding.

## When to prefer this

Use this endpoint when you need a polished, app-store-ready icon asset (SVG + PNG) built from Font Awesome glyphs without a design tool. Ideal for AI agents generating app branding, dashboard icons, or placeholder assets on the fly. Prefer over generic image generation when you need a clean, vector-based glyph icon at exact pixel sizes with predictable, configurable shapes — especially for iOS squircle format or gradient backgrounds.

## Known failure modes

- No Font Awesome icon found matching the search query — returns empty or error
- Invalid hex color format for fg or colors fields — may return 400 or default colors
- Size outside 64–1024 range — rejected with validation error
- Padding fraction outside 0.05–0.35 — rejected or clamped
- More than 2 colors supplied — gradient not applied or error
- Payment not included or insufficient — 402 Payment Required
- Unknown style variant (not solid/regular/brands) — fallback or error

## How this service works

Icon generator: pick a Font Awesome Free icon (by search query or exact name) plus background color(s) and get an app-icon-ready asset — SVG source + PNG base64, default 1024x1024 opaque squircle (iOS-ready). Options: 1-2 background colors (2 = gradient), fg glyph color, shape (squircle/rounded/circle/square/transparent), size 64-1024, padding. Returns alternatives when resolved via search.

## Output

Returns an SVG string and a base64-encoded PNG (default 1024x1024) of the composed icon. When the icon is resolved via search query rather than exact name, the response also includes alternative icon matches. The asset is rendered as an opaque squircle (or chosen shape) with the specified glyph centered and padded.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "fg": {
       "type": "string",
       "description": "Glyph hex color (default #ffffff)"
      },
      "icon": {
       "type": "string",
       "description": "Exact Font Awesome icon name (skips search)"
      },
      "size": {
       "type": "number",
       "description": "Pixel size 64-1024 (default 1024)"
      },
      "query": {
       "type": "string",
       "description": "Search text — best match is used automatically"
      },
      "shape": {
       "type": "string",
       "description": "squircle (default, iOS-style), rounded, circle, square"
      },
      "style": {
       "type": "string",
       "description": "solid (default), regular, or brands"
      },
      "colors": {
       "type": "array",
       "description": "1-2 background hex colors; 2 makes a diagonal gradient"
      },
      "padding": {
       "type": "number",
       "description": "Glyph padding as fraction 0.05-0.35 (default 0.18)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "svg": {
       "type": "string"
      },
      "icon": {
       "type": "object"
      },
      "png_base64": {
       "type": "string"
      },
      "attribution": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "svg": "<svg …>",
  "icon": {
   "name": "rocket",
   "label": "Rocket",
   "style": "solid"
  },
  "size": 1024,
  "png_base64": "iVBOR…",
  "attribution": "Icon from Font Awesome Free, CC BY 4.0."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/webbersites-icon-generator-6fb27a63/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.webbersites.com](https://www.zero.xyz/host/api.webbersites.com/llms.txt)