Published
AI Art QR codes: making them actually scan
Most AI QR generators produce beautiful images that won't scan with a real phone. Here's how Wrasse's Phase 3 add-on tackles the scannability problem head-on, with retries, gates, and a quota refund when art goes too far.
The state of AI QR codes today
AI Art QR codes β generated by diffusion models conditioned on a QR matrix β exploded in 2023. Most public generators do one pass through SDXL with a ControlNet model, hand back the image, and walk away. Half the outputs look stunning on screen and fail to scan with iPhone Camera. The user has no way to know which is which until they print the QR and watch it not work.
Why most AI QR codes fail to scan
The QR module pattern needs to dominate the local contrast. When a diffusion model is given too much creative freedom (low ControlNet weight, expressive prompt), the modules get blended into the surrounding art and lose the contrast a scanner needs. The image still looks like a QR to a human, but a phone camera samples the wrong pixels and bails out.
Wrasse's approach: SDXL + ControlNet QRCode Monster + post-validation
Phase 3 generates AI QR through Cloudflare Workers AI: SDXL Lightning conditioned on the ControlNet QRCode Monster model. After the image returns, we run the rendered PNG through jsqr in the same browser tab. If jsqr can't decode it, we don't ship it.
Scannability gates: 3-attempt retry + quota refund
When jsqr fails to decode a generation, Wrasse silently retries up to two more times with progressively higher ControlNet weight (more scannable, less artistic). If all three attempts fail to decode, the user gets back a clear error instead of a broken QR β and the AI add-on quota is refunded. Nobody pays for art that doesn't work.
Coming Phase 3 β paid-only by design
AI QR generation is a paid AI add-on, not a free-tier feature. Workers AI bills per neuron, and we don't subsidize anonymous compute. Pro and Business get optional add-ons (Β₯700/mo or Β₯2,000/mo for monthly quota with Β₯30 overage); active subscriptions enable /api/ai for that user. Free static QR stays clean and offline-capable.