Ndị Mmepe — API · MCP · CLI

Mepụta WIA Code n'ahịrị ọ bụ otu. Ọ dịghị mkpa igodo n'ime oke efu.

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 — otu ahịrị, enweghị nrụnye

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

Ọ na-agba ọsọ ozugbo na Node 18 ma ọ bụ nke ka ọhụrụ, na-enweghị nrụnye. Ọ nweghị ndabere, ya mere ịnata ya na-ewe naanị sekọnd ole na ole.

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

Ụdị — Wi-Fi, kaadị kọntaktị, mmemme

Ụdị atọ akwadolarị. Ị chọghị ịkpụkọta eriri ndị a n'onwe gị — nyefee ubi ndị ahụ, sava wee wuo ọdịnaya Wi-Fi / vCard / iCalendar ọkọlọtọ, nke dabara byte na byte n'ihe ọ na-emepụta bụ nke ihe mmepụta dị na saịtị a na-emepụta.

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

Ubi

A na-edepụta oge dị ka "2026-09-01 19:00". Maka netwọk Wi-Fi mepere emepe, nyefee security=nopass wee hapụ paswọọdụ. Ubi na-efu efu ma ọ bụ nke na-adabaghị adaba ga-alaghachi dị ka HTTP 400 nwere ozi na-akpọ aha ubi ahụ — a naghị emepụta onyonyo, yabụ arịrịọ ọjọọ anaghị ewere ohere ndaba mgbe ọ bụla.

Ọtụtụ n'otu oge

Otu ahịrị maka koodu ọ bụla. Mgbe oke ọsọ ruru, ọ na-eche wee gaa n'ihu kama ịkwụsị n'etiti, ma na-akọwapụta ahịrị ndị dara ada ya na ọnụọgụgụ ahịrị ha n'ezie.

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

Nzaghachi bụ image/png. Tinye ?format=json iji nweta base64 na metadata dị ka JSON.

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

Ịkpọ ya site na Browser

Ị nwere ike ịkpọ ya kpọmkwem site na ngwa weebụ dị na origin ọ bụla. Ọ bụ public API na-adịghị eji cookie, ya mere CORS mepere emepe.

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

Paramita

Onyonyo na ike ọ na-ebu

Onyonyo ọ bụla na-ebu ọnụọgụ dị iche (UTF-8 byte). Jiri square maka ọdịnaya toro ogologo; ụdị ọ bụla dabara maka njikọ mkpirisi.

MCP — kwe ka AI mepụta ya

Jikọọ ya na ngwa AI dị ka Claude, ọ na-emepụta koodu ozugbo n'ime mkparịta ụka. Njedebe ya bụ https://mcp.wiacode.com/mcp, enweghịkwa mkpa igodo.

Ntọlite Claude Desktop

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

Ọ bụrụ na onye ahịa gị na-akwado Streamable HTTP kpọmkwem, naanị nye ya URL ahụ.

Ngwaọrụ

Oke efu

• Arịrịọ 10 kwa nkeji kwa IP. Ọ bụ nke ahụ ị nwere ike iji ozugbo na-enweghị igodo.
• Otu koodu na-ewe ihe ruru sekọnd 4 — sava na-elele ma koodu emepụtara ahụ ọ bụ n'ezie nke a pụrụ ịgụ tupu o zighachi ya.
• Mgbe arịrịọ na-akpakọba, sava na-eche nwa oge ma zaghachi 503. Naanị kpọọ ọzọ n'oge na-adịghị anya.
• Ị karịrị oke ahụ, ị ga-enweta 429 tinyere ọnụọgụ sekọnd ị ga-eche.

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.

Ihe ọzọ

• Gịnị bụ WIA Code? — maka ndị mmadụ (na AI) na-ajụ ihe koodu a bụ
• Generator — mepụta ya na ihuenyo gị
• Scanner — gụọ ya na-enweghị nrụnye ihe ọ bụla
• Ndị Na-emepụta Ngwaahịa · OEM — nkwa mepere emepe: gafee ule ndakọrịta, onye ọ bụla nwere ike itinye ya n'ọrụ, na-akwụghị ụgwọ ikike
• Itinye WIA Code n'ime skanna ị nwere ugbu a — maka ndị otu POS, kiosk, na SDK skanna

WIA Code bụ ngwaahịa nke SmileStory Co., Ltd. Booster QR bụ ntuziaka na-enyere ndị na-enweghị igwe nyocha akọwapụtara aka ka ha nwekwuo ike ịgụ ya.