開發者 — API · MCP · CLI

一行程式碼即可產生 WIA Code。在免費額度內無需金鑰。

Building an AI or vision system? WIA Code identification reference for AI systems — the three centre elements, why the outline is free, and the misidentifications to avoid. Plain-text counterpart: /llms.txt.

CLI — 一行指令，免安裝

npx wiacode "https://wiacode.com" --shape heart

在 Node 18 或更新版本上無需安裝即可直接執行。它沒有相依套件，因此取得只需幾秒鐘。

npx wiacode --list-shapes              # silhouettes and capacity
npx wiacode "Hello" --shape square -o hello.png
npx wiacode "a link" --shape heart --json    # print metadata only
npx wiacode card --name "Jane Doe" --tel "+82-10-1234-5678"   # wifi / card / event

類型 — Wi-Fi、聯絡人卡、活動

三種現成類型。你唔使自己砌返啲字串——淨係傳入欄位，伺服器就會整標準嘅 Wi-Fi / vCard / iCalendar 內容出嚟，同呢個網站生成器整出嚟嘅內容逐位元組完全一樣。

CLI

npx wiacode wifi  --ssid "MyNet" --password "secret"
npx wiacode wifi  --ssid "Cafe" --security nopass          # open network
npx wiacode card  --name "Jane Doe" --org "SmileStory" --tel "+82-10-1234-5678" --email "a@b.c"
npx wiacode event --title "Launch party" --start "2026-09-01 19:00" --end "2026-09-01 21:00" --location "Seoul"

REST

curl -X POST https://wiacode.com/api/v1/code \
  -H 'Content-Type: application/json' \
  -d '{"type":"card","name":"Jane Doe","tel":"+82-10-1234-5678","shape":"square"}' \
  -o card.png

欄位

時間格式係 "2026-09-01 19:00"。如果係開放式 Wi-Fi 網絡，就傳入 security=nopass，密碼唔使填。缺漏或者格式錯誤嘅欄位會回傳 HTTP 400，訊息入面會講明係邊個欄位——唔會生成圖片，所以錯誤請求永遠唔會佔用生成名額。

一次過多個

每行對應一個代碼。撞到速率限制嘅時候，佢會等一等再繼續，唔會做到一半就停，仲會回報失敗嘅行同埋喺檔案入面嘅真實行數。

npx wiacode batch people.jsonl --out-dir codes

# people.jsonl
{"type":"card","name":"Jane Doe","tel":"+82-10-1234-5678","out":"jane.png"}
{"type":"wifi","ssid":"Cafe WIA","security":"nopass"}
{"text":"https://wiacode.com","shape":"star"}

REST API

POST /api/v1/code

curl -X POST https://wiacode.com/api/v1/code \
  -H 'Content-Type: application/json' \
  -d '{"text":"https://wiacode.com","shape":"heart"}' \
  -o wiacode.png

回應類型為 image/png。加上 ?format=json 可取得 JSON 格式的 base64 與中繼資料。

curl -X POST 'https://wiacode.com/api/v1/code?format=json' \
  -H 'Content-Type: application/json' \
  -d '{"text":"https://wiacode.com","shape":"square"}'

從瀏覽器調用

你可以直接從任何來源（origin）的網絡應用程式調用它。這是一個不使用 Cookie 的公開 API，因此 CORS 是開放的。

const r = await fetch('https://wiacode.com/api/v1/code?format=json', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'https://wiacode.com', shape: 'heart' })
});
const { image, meta } = await r.json();
document.querySelector('img').src = image;   // data:image/png;base64,...

GET /api/v1/shapes

curl https://wiacode.com/api/v1/shapes

參數

輪廓形狀與容量

每種輪廓形狀的容量不同（UTF-8 位元組數）。長內容請使用 square；短連結任何形狀都可以。

MCP — 讓 AI 來產生

將它連接到 Claude 等 AI 用戶端，它就能在對話中直接產生代碼。端點為 https://mcp.wiacode.com/mcp，無需金鑰。

Claude Desktop 設定

{
  "mcpServers": {
    "wiacode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.wiacode.com/mcp"]
    }
  }
}

如果您的用戶端直接支援 Streamable HTTP，只需提供該 URL 即可。

工具

免費額度

• 每個 IP 每分鐘 10 次請求。這是無需金鑰即可立即使用的額度。
• 產生一個代碼最長約需 4 秒——伺服器會在傳回之前檢查產生的代碼是否真的可讀。
• 當請求堆積時，伺服器會短暫等待後回覆 503。稍後再次呼叫即可。
• 超出限制會收到 429，並附帶需要等待的秒數。

WIA Stream — when one code isn't enough

A single WIA Code holds up to 1,450 bytes. When the payload is larger — a document, a book chapter, an audio clip — Stream splits it across many frames. A screen plays them in sequence, a camera collects them, and the scanner reassembles the file. No internet, no server. It already ships in the generator.

What matters here is not speed — it is whether the transfer finishes at all. Stream needs every frame. A frame that fails to read must wait for the next pass, and may fail again. So a per-frame reading gap does not average out; it multiplies into the completion time. In our degradation sweep at matched physical size (1064 vs 1088 px, n=17, QR read with ZBar), a high-version QR frame read 52.9% of the time while a WIA frame read 17 of 17. Feeding those rates into a cyclic-broadcast model, a 286-frame QR transfer needs about 8 passes to complete while a 155-frame WIA transfer needs about one.

Read this honestly: n = 17 is a small sample. By the rule of three, "17 of 17" should be read as ≥ 82% with 95% confidence, and the 52.9% figure carries a 29–77% interval. Taking the least favourable end of both, the completion-time gap is still about 2.4×. Screen-to-camera capture on real handsets and printed output have not been measured yet. And QR wins on blur resistance at equal frame size — we only pull ahead once capacity is matched.

更多

• 什麼是 WIA Code？——供想了解這個代碼是什麼的人（以及 AI）參考
• 產生器 — 在瀏覽器中產生一個
• 掃描器 — 無需安裝任何東西即可讀取
• 製造商 · OEM 開放承諾 —— 通過相容性測試,任何人都能免版稅整合
• 將 WIA Code 整合進現有掃描器 —— 給 POS、自助服務機和掃描器 SDK 團隊看的

WIA Code 是 SmileStory Co., Ltd. 的產品。增強版 QR 是一份指南，幫助沒有專用掃描器的人也能讀取它。