# esyURL Styled QR Code Generator

> esyURL Styled QR Code Generator is a paid API for AI agents from esyurl.fyi, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Generates a customizable, styled QR code image (PNG or SVG) encoding a URL or text, with optional logo/halftone image overlay, custom colors, and shape variants.

## Facts

- Endpoint: POST https://esyurl.fyi/x402/qr?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/esyurl-styled-qr-code-generator-1ace2daf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AXVvL1LkfOrsnzyFxvoCd

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 esyurl-styled-qr-code-generator-1ace2daf -d '<json body>'
```

Example prompt: Generate a styled QR code for https://myshop.com — make it 512 pixels, use dark purple (#4B0082) modules with rounded dot style, white background, circle eye frames and balls, and embed my logo (attached PNG) in the center at 20% size. Output as PNG.

## When to prefer this

Choose this endpoint when you need a visually customized QR code with brand colors, embedded logos, halftone overlays, or specific module and eye shapes — beyond what basic free QR generators offer. Ideal for marketing materials, print collateral, or any use case requiring branded, print-quality QR codes in PNG or SVG format. Prefer this over generic QR APIs when custom styling (dot shapes, colors, image embeds) is a requirement.

## Known failure modes

- Data string exceeds 2048 characters — QR code cannot encode the payload
- Embedded image exceeds 2 MB limit or is an unsupported format — image rejected
- Size parameter out of range (must be 64–2048) — validation error
- Invalid hex color values for dark/light/eyeColor — may return error or default
- Image size ratio out of 0.1–0.3 range — validation error
- Payment not provided or insufficient — 402 Payment Required

## How this service works

A styled QR code (module shapes, corner markers, a logo or a halftone photo) for any text, no account needed

## Output

A binary image file: either a PNG or SVG of the generated QR code, incorporating the requested colors, module shapes, eye styles, size, and optional embedded image. The image is returned directly as binary content with the appropriate MIME type (image/png or image/svg+xml).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dark": {
   "type": "string"
  },
  "data": {
   "type": "string",
   "description": "What the code encodes: a URL or any text, up to 2048 characters"
  },
  "size": {
   "type": "integer",
   "maximum": 2048,
   "minimum": 64
  },
  "image": {
   "type": "object",
   "required": [
    "mode",
    "data"
   ],
   "properties": {
    "data": {
     "type": "string",
     "description": "data:image/png;base64,... (png, jpeg, webp or gif, up to 2 MB)"
    },
    "mode": {
     "enum": [
      "logo",
      "halftone"
     ],
     "type": "string"
    },
    "size": {
     "type": "number",
     "maximum": 0.3,
     "minimum": 0.1
    }
   }
  },
  "light": {
   "type": "string"
  },
  "format": {
   "enum": [
    "png",
    "svg"
   ],
   "type": "string"
  },
  "eyeBall": {
   "enum": [
    "square",
    "rounded",
    "circle"
   ],
   "type": "string"
  },
  "modules": {
   "enum": [
    "square",
    "rounded",
    "dot",
    "row",
    "column"
   ],
   "type": "string"
  },
  "eyeColor": {
   "type": "string"
  },
  "eyeFrame": {
   "enum": [
    "square",
    "rounded",
    "circle"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "binary",
 "format": "image/png (or image/svg+xml with \"format\": \"svg\")"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/esyurl-styled-qr-code-generator-1ace2daf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from esyurl.fyi](https://www.zero.xyz/host/esyurl.fyi/llms.txt)