डेभलपरहरू — 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 हो। 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

प्यारामिटरहरू

सिल्हुएटहरू र क्षमता

प्रत्येक सिल्हुएटले फरक मात्रा समाउँछ (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 प्रति मिनेट १० अनुरोध। यो कुञ्जी बिना तुरुन्तै प्रयोग गर्न सकिने हो।
• एउटा कोडलाई करिब ४ सेकेन्डसम्म लाग्छ — बनाइएको कोड साँच्चै पढ्न मिल्छ कि भनेर सर्भरले फिर्ता पठाउनुअघि जाँच गर्छ।
• अनुरोधहरू थुप्रिएमा सर्भर केही समय पर्खेर 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 ले मद्दत गर्छ।