ገንቢዎች — 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 / 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 ነው። 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"}'

ከአሳሽ መጥራት

ከማንኛውም ምንጭ ያለ ድር መተግበሪያ በቀጥታ መጥራት ይችላሉ። ኩኪዎችን የማይጠቀም ይፋዊ 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 ልዩ ስካነር ለሌላቸው ሰዎችም እንዲያነቡት የሚረዳ መመሪያ ነው።