ಡೆವಲಪರ್‌ಗಳಿಗಾಗಿ — 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.

ಬೂಸ್ಟರ್ QR ಯಾವಾಗಲೂ ಸೇರಿಸಲಾಗಿದೆ. ಇದನ್ನು ಆಫ್ ಮಾಡುವ ಆಯ್ಕೆ ಇಲ್ಲ — API, MCP ಮತ್ತು CLI ಗೂ ಇದೇ ಅನ್ವಯಿಸುತ್ತದೆ. "ಸಂಚಿತ ಬಳಕೆ 10 ಕೋಟಿ ಬಾರಿ ತಲುಪಿದಾಗ, ಬೂಸ್ಟರ್ ಬೇರ್ಪಡುತ್ತದೆ ಮತ್ತು ಅದರ ಜಾಗದಲ್ಲಿ ನಿಮ್ಮ ಸ್ವಂತ ಲೋಗೋ ಬರುತ್ತದೆ" ಎಂಬುದು ಉತ್ಪನ್ನದ ಭರವಸೆಯಾಗಿರುವುದರಿಂದ, ನಾವು ಯಾವುದೇ ಒಂದು ಮಾರ್ಗಕ್ಕೆ ವಿನಾಯಿತಿ ನೀಡಿಲ್ಲ. ಎನ್‌ಕೋಡಿಂಗ್ ಪ್ಯಾರಾಮೀಟರ್‌ಗಳು (grid, bpc, bridge) ಸಹ ಸರ್ವರ್‌ನಲ್ಲಿ ಸ್ಥಿರವಾಗಿವೆ.

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 / 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

ಫೀಲ್ಡ್‌ಗಳು

type	ಕಡ್ಡಾಯ	ಐಚ್ಛಿಕ
wifi	ssid, password	security (WPA·WEP·nopass), hidden
card	name	org, tel, email
event	title, start	end, location, desc

ಸಮಯಗಳು "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 ಆಗಿದೆ. base64 ಮತ್ತು ಮೆಟಾಡೇಟಾವನ್ನು JSON ಆಗಿ ಪಡೆಯಲು ?format=json ಸೇರಿಸಿ.

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

ಬ್ರೌಸರ್‌ನಿಂದ ಕರೆ ಮಾಡುವುದು

ಯಾವುದೇ origin ನಲ್ಲಿರುವ ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್‌ನಿಂದ ನೀವು ಇದನ್ನು ನೇರವಾಗಿ ಕರೆ ಮಾಡಬಹುದು. ಇದು ಕುಕೀಗಳನ್ನು ಬಳಸದ ಸಾರ್ವಜನಿಕ 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

ಪ್ಯಾರಾಮೀಟರ್‌ಗಳು

ಹೆಸರು	ಕಡ್ಡಾಯ	ವಿವರಣೆ
text	✓	ಎನ್‌ಕೋಡ್ ಮಾಡಬೇಕಾದ ಪಠ್ಯ ಅಥವಾ URL. ಉದ್ದದ URL ಗಳನ್ನು ಮೊದಲು ಚಿಕ್ಕದಾಗಿಸುವುದು ಉತ್ತಮ.
type	—	`wifi` · `card` · `event`. `text` ಬದಲಿಗೆ ನೀಡಲಾಗುತ್ತದೆ — ಸರ್ವರ್ ಫೀಲ್ಡ್‌ಗಳಿಂದ ಪ್ರಮಾಣಿತ ಸ್ಟ್ರಿಂಗ್ ಅನ್ನು ಜೋಡಿಸುತ್ತದೆ. ಮೇಲಿನ “ವಿಧಗಳು” ವಿಭಾಗವನ್ನು ನೋಡಿ.
shape	—	ಸಿಲೂಯೆಟ್ (ಡೀಫಾಲ್ಟ್ `heart`). ಕೆಳಗಿನ ಟೇಬಲ್ ನೋಡಿ.
cellPx	—	ಪ್ರತಿ ಸೆಲ್‌ಗೆ ಪಿಕ್ಸೆಲ್‌ಗಳು (3–20, ಡೀಫಾಲ್ಟ್ 8). ಹೆಚ್ಚಿನ ಮೌಲ್ಯ ಎಂದರೆ ದೊಡ್ಡ ಚಿತ್ರ.
label	—	ಮೆಟಾಡೇಟಾದಲ್ಲಿ ಉಳಿಸಿಟ್ಟ ಲೇಬಲ್. ಇದನ್ನು ಚಿತ್ರದ ಮೇಲೆ ಬರೆಯಲಾಗುವುದಿಲ್ಲ.

ಸಿಲೂಯೆಟ್‌ಗಳು ಮತ್ತು ಸಾಮರ್ಥ್ಯ

ಪ್ರತಿ ಸಿಲೂಯೆಟ್ ವಿಭಿನ್ನ ಪ್ರಮಾಣವನ್ನು (UTF-8 ಬೈಟ್‌ಗಳು) ಹಿಡಿದಿಟ್ಟುಕೊಳ್ಳುತ್ತದೆ. ದೀರ್ಘ ವಿಷಯಕ್ಕೆ square ಬಳಸಿ; ಚಿಕ್ಕ ಲಿಂಕ್‌ಗಳಿಗೆ ಯಾವುದೇ ಆಕಾರ ಸೂಕ್ತ.

shape	bytes	shape	bytes
square	1450	rose	586
round	1093	clover	521
hex	861	star	386
heart	854	boomerang	386

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 ಅನ್ನು ಕೊಡಿ.

ಟೂಲ್‌ಗಳು

ಸಾಧನ	ಏನು ಮಾಡುತ್ತದೆ
get_wia_code_info	WIA Code ಎಂದರೇನು, ಇದು QR ಕೋಡ್‌ಗಿಂತ ಹೇಗೆ ಭಿನ್ನ, ಮತ್ತು ಪ್ರತಿ ಸಿಲೂಯೆಟ್‌ನ ಸಾಮರ್ಥ್ಯವನ್ನು ವಿವರಿಸುತ್ತದೆ. ಇದನ್ನು ಮೊದಲು ಕರೆಯುವುದರಿಂದ ವೈಫಲ್ಯಗಳು ಕಡಿಮೆಯಾಗುತ್ತವೆ.
generate_wia_code	ಪಠ್ಯವನ್ನು ಕೋಡ್ ಚಿತ್ರವಾಗಿ ಪರಿವರ್ತಿಸುತ್ತದೆ. ಸಾಮರ್ಥ್ಯ ಮೀರಿದರೆ, ಯಾವ ಸಿಲೂಯೆಟ್‌ಗಳು ಸೂಕ್ತ ಎಂದು ಹೇಳುತ್ತದೆ.
generate_wia_code_wifi	Wi-Fi ರುಜುವಾತುಗಳು — ಸ್ಕ್ಯಾನ್ ಮಾಡುವುದರಿಂದ ಪಾಸ್‌ವರ್ಡ್ ಟೈಪ್ ಮಾಡದೆಯೇ ನೆಟ್‌ವರ್ಕ್‌ಗೆ ಸೇರುತ್ತದೆ.
generate_wia_code_card	ಪ್ರಮಾಣಿತ vCard ಆಗಿ ಸಂಪರ್ಕ — ಸ್ಕ್ಯಾನ್ ಮಾಡುವುದರಿಂದ ಅದನ್ನು ಫೋನ್‌ನ ಸಂಪರ್ಕಗಳಿಗೆ ಉಳಿಸಲು ಪ್ರಸ್ತಾಪಿಸುತ್ತದೆ.
generate_wia_code_event	ಪ್ರಮಾಣಿತ iCalendar ಆಗಿ ಈವೆಂಟ್ — ಸ್ಕ್ಯಾನ್ ಮಾಡುವುದರಿಂದ ಅದನ್ನು ಕ್ಯಾಲೆಂಡರ್‌ಗೆ ಸೇರಿಸುತ್ತದೆ.

ಉಚಿತ ಮಿತಿಗಳು

ಪ್ರತಿ IP ಗೆ ನಿಮಿಷಕ್ಕೆ 10 ವಿನಂತಿಗಳು. ಕೀ ಇಲ್ಲದೆ ತಕ್ಷಣ ಬಳಸಬಹುದಾದದ್ದು ಇಷ್ಟೇ.
ಒಂದು ಕೋಡ್‌ಗೆ ಸುಮಾರು 4 ಸೆಕೆಂಡುಗಳವರೆಗೆ ಸಮಯ ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ — ಸರ್ವರ್ ಅದನ್ನು ಹಿಂತಿರುಗಿಸುವ ಮೊದಲು, ರಚಿಸಿದ ಕೋಡ್ ನಿಜವಾಗಿಯೂ ಓದಬಹುದೇ ಎಂದು ಪರಿಶೀಲಿಸುತ್ತದೆ.
ವಿನಂತಿಗಳು ಸಂಗ್ರಹವಾದಾಗ, ಸರ್ವರ್ ಸ್ವಲ್ಪ ಕಾಯುತ್ತದೆ ಮತ್ತು ನಂತರ 503 ಎಂದು ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತದೆ. ಸ್ವಲ್ಪ ಸಮಯದ ನಂತರ ಮತ್ತೆ ಕರೆ ಮಾಡಿ.
ಮಿತಿ ಮೀರಿದರೆ ನಿಮಗೆ 429 ಜೊತೆಗೆ ಎಷ್ಟು ಸೆಕೆಂಡುಗಳು ಕಾಯಬೇಕು ಎಂಬುದು ಸಿಗುತ್ತದೆ.

ನಿಮಗೆ ಹೆಚ್ಚು ಬೇಕಿದ್ದರೆ — ಬೃಹತ್ ವಿತರಣೆ, ಪಾಲುದಾರಿಕೆ ಅಥವಾ ವಾಣಿಜ್ಯ ಬಳಕೆಗಾಗಿ, ನಮಗೆ ಇಮೇಲ್ ಕಳುಹಿಸಿ. ನಾವು ಮಿತಿಯನ್ನು ಹೆಚ್ಚಿಸುವ ಕೀಯನ್ನು ನಿಮಗೆ ನೀಡುತ್ತೇವೆ. wiasoom@smilestory.ai

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 SmileStory Co., Ltd. ಸಂಸ್ಥೆಯ ಉತ್ಪನ್ನವಾಗಿದೆ. ಬೂಸ್ಟರ್ QR ಎಂಬುದು ಮೀಸಲಾದ ಸ್ಕ್ಯಾನರ್ ಇಲ್ಲದವರಿಗೂ ಅದನ್ನು ಓದಲು ಸಹಾಯ ಮಾಡುವ ಮಾರ್ಗದರ್ಶಿ.