Developer API Reference

Welcome to the MicroAI Developer Portal. MicroAI provides highly performant API proxy endpoints fully compatible with mainstream models (OpenAI GPT, Gemini, and DeepSeek) using our secure, low-latency, routing network.

Our endpoints are built on standard OpenAI-compatible request/response schemas. This means you can drop MicroAI straight into your pre-existing code, scripts, or systems by doing nothing more than swapping your API key and changing your target SDK base URL.

Authentication

Authenticate your requests by generating a secure key on your Developer Dashboard and passing it in the HTTP Authorization header:

Authorization: Bearer mci-live-your_generated_secure_key

Keep your keys strictly confidential. Every request made with your key counts towards your plan limit. If a key is compromised, you can instantly revoke and replace it from your subscription dashboard.

Chat Completions Reference

Submit chat-based queries to our unified endpoint. We support full text replies as well as real-time **SSE (Server-Sent Events) streaming** for instant typing responses.

HTTP Request

POST https://api.dotmini.net/v1/chat/completions

Headers

Request Parameters

Developer Integration Snippets

Choose your favorite language tab below to see how easy it is to link MicroAI into your codebase.

import os
from openai import OpenAI

# Initialize client pointing to our API Gateway
client = OpenAI(
    api_key="mci-live-your-generated-key-here",
    base_url="https://api.dotmini.net/v1"
)

# Request standard streaming completion
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "สวัสดี MicroAI จาก Dotmini"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

const OpenAI = require('openai');

// Initialize client pointing to our API Gateway
const openai = new OpenAI({
  apiKey: 'mci-live-your-generated-key-here',
  baseURL: 'https://api.dotmini.net/v1'
});

async function main() {
  // Request streaming completion
  const stream = await openai.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: 'สวัสดี MicroAI จาก Dotmini' }],
    stream: true,
  });
  
  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

main();

curl -X POST https://api.dotmini.net/v1/chat/completions \
  -H "Authorization: Bearer mci-live-your-generated-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "สวัสดี MicroAI จาก Dotmini"}],
    "stream": false
  }'

Quotas & Billing

MicroAI API usage is fully integrated into your main active subscription plan. Each successful request processed by our gateway decrements your account's monthly request quota.

Below are the monthly request allocations for our standard tiers:

Once your monthly limit is exhausted, further API proxy requests will return an HTTP response code of 429 Too Many Requests with an OpenAI-structured JSON payload explaining that your quota has been reached. You can easily upgrade your tier from the Subscription Dashboard.

รายละเอียดการทำงานของระบบสำคัญเชิงลึก (Deep Technical Specification)

1. ระบบประหยัด Token (Save AI Token)

เพื่อลดต้นทุนค่า API ของโมเดลและป้องกันปัญหาความล่าช้า (Latency) จากข้อมูลประวัติที่ใหญ่เกินไป ระบบได้ออกแบบมาตรการประหยัด Token ดังนี้:

• Text Normalization (การแปลงข้อความให้อยู่ในรูปแบบมาตรฐาน): ก่อนจะสร้าง Hash Key เพื่อตรวจสอบแคชหรือส่งต่อไปยังโมเดลปลายทาง ระบบ Go Gateway จะทำการแปลงข้อความทั้งหมดเป็นตัวพิมพ์เล็ก (Lowercase) ลบช่องว่างหรือการเคาะบรรทัดซ้ำซ้อนให้เหลือช่องว่างเดี่ยว และทำการตัดอักขระเครื่องหมายวรรคตอนท้ายประโยคทั้งหมดออก เช่น ?, !, ., ,, ，, 。
  • ผลลัพธ์: แม้ผู้ใช้จะถามคำถามเดียวกันแต่เคาะเว้นวรรคไม่เท่ากันหรือลืมใส่เครื่องหมายคำถาม ระบบจะสามารถมองเห็นเป็นประโยคเดียวกันและดึงข้อมูลจากแคชกลับไปตอบได้ทันที 100% โดยไม่ต้องส่งคำร้องขอไปประมวลผลใหม่ที่ LLM
• Context Budgeting (การจัดการความยาวประวัติบทสนทนาเลื่อนไหล): ระบบจำกัดขอบเขตและประเมินประวัติการคุยเก่า โดยจะทำการปัดเศษและล้างข้อความที่ไม่จำเป็นออกก่อนส่งเข้าโมเดล (Sliding Context Window Limit) เพื่อไม่ให้ Token ของ Prompt สะสมเกินขีดจำกัด
• Vector Path instead of Base64 Images: ในการประมวลผลภาพวาดหน้าจอ (Scratchpad Canvas) ของโหมดฝึกฝนการเรียนรู้ ระบบจะบันทึกเป็นลายเส้นพิกัดเวกเตอร์ JSON ขนาดประมาณ 1.5KB แทนที่จะทำการบีบอัดเป็นรูปภาพ Base64 ส่งเข้าไปยังโมเดล Vision (ซึ่งสิ้นเปลืองแบนด์วิดท์และกินจำนวน Token สูงถึง 85-1100 tokens ต่อหนึ่งรูปภาพสำหรับ OpenAI/Claude Vision models)

2. ระบบแคชหน่วยความจำ (Memory Caching Layers)

ระบบ Go Proxy Gateway จัดการแคชข้อมูลใน RAM เพื่อลดการทำงานฝั่ง Network Round-trips แยกประเภทตามความเหมาะสมด้วยระบบ TTL (Time-to-Live) ดังนี้:

• Firebase JWT Auth Cache (5-Minute TTL): แคชความถูกต้องของ ID Token ของ Firebase ที่ผ่านการยืนยันสิทธิ์แล้ว ทำให้ Go Backend ไม่ต้องยิง HTTP Request ไปยืนยันตัวตนกับ Google Identity Toolkit API (accounts:lookup) ทุกครั้ง ช่วยลดเวลาหน่วง (Latency) ลง 100ms - 300ms ต่อหนึ่ง Request
• User Profile & Quota Cache (30-Second TTL): แคชจำนวนการใช้โควตา API (aiUsed) และแผนสมาชิกปัจจุบันของผู้ใช้ ทำให้อุปกรณ์สามารถสนทนาอย่างต่อเนื่องด้วยความเร็วสูงโดยไม่ก่อให้เกิดภาระการอ่านฐานข้อมูล Firebase Realtime Database (RTDB) แบบ 1:1
• API Key Cache (1-Minute TTL): ตรวจสอบสิทธิ์สัญญานักพัฒนา (mci-live-...) จากข้อมูลที่แคชไว้ใน RAM ช่วยประหยัดเวลาเช็กสิทธิ์
• Configuration Cache (1-Minute TTL) พร้อม Deep-Cloning: แคชการตั้งค่าการเปิดใช้โมเดล โดยพัฒนาระบบคัดลอกแผนผังข้อมูลลึก (cloneMap) เพื่อป้องกันความขัดแย้งของข้อมูลในระดับมัลติเธรด (Prevent Concurrent Map Read/Write Panic)
• Transparent GZIP Serialization Cache: ประวัติแคชการทำ Completions ทั้งหมดจะถูกบีบอัดลงไฟล์ดิสก์ ai_cache.json.gz โดยอัตโนมัติผ่าน compress/gzip ช่วยลดขนาดพื้นที่เก็บข้อมูลบนดิสก์และแบนด์วิดท์ในการซิงก์ข้อมูลไป 90%

3. ระบบรักษาบริบทและบทบาทโมเดล (AI Mem / Context & Persona Preservation)

เพื่อให้คำตอบของ AI สอดคล้องกับหัวข้อการเรียนรู้และความเป็นส่วนตัวของผู้ใช้ ระบบจึงมีกลไกควบคุมบริบทดังนี้:

• System Prompt Locking & Injection: ทันทีที่ระบบตรวจพบหัวข้อเฉพาะหรือผู้ใช้เลือกบทบาท เช่น Data Science Student หรือ CS Student ระบบ Gateway จะทำการล็อกและบังคับแทรก System Prompt ประจำบทบาทนั้นเข้าไปใน API Request Payload เพื่อบังคับพฤติกรรมและการตอบสนองของโมเดลปลายทาง (เช่น บังคับให้เขียนโค้ดและวิเคราะห์ Time Complexity ทุกครั้ง)
• Session Persistence via Project Metadata: ข้อมูลบทบาทและ System prompt เฉพาะห้องทำงานจะบันทึกภายใต้ UID ของผู้ใช้ลง Firebase เสมอ ทำให้แม้ผู้ใช้จะสลับห้องสนทนาหรือรีเฟรชหน้าเบราว์เซอร์ AI ก็ยังคงประพฤติตนตามบริบทเดิมได้อย่างถูกต้องแม่นยำ

4. ระบบลายเส้นเวกเตอร์แคนวาส (Vec Mem / Canvas Stroke Normalization)

เมื่อผู้เรียนวาดแผนภาพหรือสูตรบน Scratchpad Canvas ในโหมดทดลองสอบ ข้อมูลจะถูกประมวลผลด้วยเทคนิคการเก็บพิกัดพิกเซลยืดหยุ่น:

• Coordinate Normalization (สูตรการแปลงพิกัดมาตรฐาน): เมื่อผู้ใช้วาดเส้นบนอุปกรณ์ที่มีขนาดหน้าจอต่างกัน (เช่น ไอแพด มือถือ หรือหน้าจอคอมพิวเตอร์) React Front-end จะแปลงพิกัดจุด (x, y) จริงบนแคนวาสของหน้าจอไปเป็นระบบกริดเวกเตอร์จำลอง 1000x1000 เสมอตามสูตร:
  vx = Math.round((x / canvas.width) * 1000)
  vy = Math.round((y / canvas.height) * 1000)
• Serialization & Format: ข้อมูลเส้นพู่กันและยางลบจะถูกบันทึกเป็น String JSON ชุดเล็ก ๆ:

  [
    {"tool": "pen", "color": "#7c3aed", "size": 3, "points": [[120, 240], [125, 243]]},
    {"tool": "eraser", "color": "#09090b", "size": 8, "points": [[150, 300], [155, 305]]}
  ]

• Adaptive Scale Rendering: เมื่ออุปกรณ์อื่น ๆ หรือหน้าต่าง History modal อ่านลายเส้นขึ้นมาแสดงผล ส่วนประกอบ HistoryCanvas จะนำค่าพิกัดพิกเซลกริด 1000x1000 มาคูณกลับด้วยค่าอัตราส่วนความกว้างและสูงปัจจุบันของตัวแคนวาสของอุปกรณ์ปลายทาง (scaleX = canvas.width / 1000 และ scaleY = canvas.height / 1000) ทำให้ภาพวาดไม่เบี้ยว คมชัด และสเกลพอดีหน้าจอเสมอ
• ประสิทธิภาพ: ลดพื้นที่การจัดเก็บเอกสารในฐานข้อมูล Firebase เหลือเพียง 1.5KB เทียบกับภาพวาด Base64 แบบเดิมที่หนาถึง 200KB - 1MB (ประหยัดแบนด์วิดท์ไปกว่า 99.2%) และยังสามารถแปลงข้อมูลเวกเตอร์ชุดนี้เป็นรูปแบบ SVG หรือนำไปคำนวณเชิงคณิตศาสตร์ต่อยอดได้ทันที

Terms of Service (เงื่อนไขการใช้บริการ)

อัปเดตล่าสุด: 3 มิถุนายน 2026

ยินดีต้อนรับสู่ MicroAI (ซึ่งต่อไปนี้จะเรียกว่า "ผู้ให้บริการ" หรือ "เรา") กรุณาอ่านเงื่อนไขการให้บริการฉบับนี้โดยละเอียดก่อนเข้าใช้งานระบบ แพลตฟอร์ม หรือคีย์เชื่อมต่อของนักพัฒนา (API Key) ของเรา การเข้าถึงหรือใช้งานส่วนใดส่วนหนึ่งของระบบ ถือว่าท่านยอมรับข้อตกลงและเงื่อนไขการใช้บริการนี้โดยสมบูรณ์ หากท่านไม่ตกลงในข้อกำหนดใดๆ กรุณายุติการใช้งานทันที

1. การลงทะเบียนและการรักษาความปลอดภัยของบัญชี

• คุณสมบัติผู้ใช้งาน: ผู้ใช้งานจะต้องให้ข้อมูลที่เป็นจริง ถูกต้อง และเป็นปัจจุบันในระหว่างการลงทะเบียนผ่านช่องทางล็อกอินของแพลตฟอร์ม
• ความรับผิดชอบในบัญชี: ท่านมีหน้าที่รักษารหัสผ่านของบัญชีรวมถึงคีย์เชื่อมต่อนักพัฒนา (API Key ที่ขึ้นต้นด้วย mci-live-) ไว้เป็นความลับสูงสุด การกระทำใดๆ ที่เกิดขึ้นภายใต้บัญชีหรือ API Key ของท่าน จะถือเป็นความรับผิดชอบของท่านแต่เพียงผู้เดียว
• กรณีข้อมูลรั่วไหล: หากท่านพบหรือสงสัยว่า API Key หรือสิทธิ์การเข้าถึงบัญชีของท่านถูกละเมิดหรือรั่วไหล ท่านต้องทำการเพิกถอน (Revoke) คีย์เดิมและสร้างคีย์ใหม่ทันทีผ่าน Subscription Dashboard ของท่าน และแจ้งให้ผู้ให้บริการทราบโดยเร็วที่สุด

2. ขอบเขตสิทธิ์การใช้งาน (API Usage & Quotas)

• สิทธิ์การใช้งานตามแผนสมาชิก: สิทธิ์ในการส่งคำขอประมวลผล (API Request) และการใช้โมเดล AI จะถูกจำกัดตามโควตาและเงื่อนไขของแพ็คเกจการสมัครสมาชิกปัจจุบันของท่าน (เช่น Lite, Pro, Advanced, หรือ Universal Bundle)
• ข้อจำกัดอัตราการส่งคำขอ (Rate Limiting): เพื่อรักษาประสิทธิภาพของระบบ เราจำกัดจำนวนคำขอประมวลผลที่ส่งเข้ามาจากแต่ละบัญชี/แต่ละ IP หากมีการยิงระบบเกินเกณฑ์ที่กำหนด (Rate Limit Exceeded) ระบบจะปฏิเสธคำร้องขอด้วย HTTP Code 429 (Too Many Requests)
• การห้ามกระทำผิดวัตถุประสงค์: ห้ามนำ API Key หรือระบบ MicroAI ไปใช้ในการยิงโจมตีระบบ (DDoS), พยายามแทรกแซงโครงสร้างพื้นฐาน, สแกนช่องโหว่โดยไม่ได้รับอนุญาต, หรือใช้ในกิจกรรมที่ขัดต่อกฎหมายและศีลธรรมอันดี

3. นโยบายการใช้ข้อมูลของโมเดล AI (Third-Party Data Disclaimer)

MicroAI ทำหน้าที่เป็นตัวกลางส่งต่อคำขอ (Reverse Proxy Gateway) ไปยังโมเดลปัญญาประดิษฐ์ของผู้ให้บริการภายนอก (เช่น OpenAI, Google Gemini, DeepSeek) ข้อมูลเนื้อหา (Payload) ที่ท่านส่งเข้าสู่ระบบจะถูกส่งผ่าน TLS ไปยังผู้ให้บริการเหล่านี้เพื่อประมวลผลคำตอบ

ข้อเท็จจริงทางกฎหมายและสัญญาการใช้งาน: ตามข้อตกลงการใช้งาน API อย่างเป็นทางการของผู้ให้บริการโมเดล AI ปลายทาง (OpenAI API, Google Gemini API, และ DeepSeek API) ข้อมูลทั้งหมดที่ส่งผ่านช่องทาง API **จะไม่ถูกนำไปใช้ในกระบวนการฝึกอบรม (Train) โมเดลพื้นฐาน** ของผู้ให้บริการเหล่านั้น อย่างไรก็ดี ท่านมีหน้าที่รับผิดชอบในการหลีกเลี่ยงการส่งข้อมูลที่เป็นความลับส่วนบุคคลที่ละเอียดอ่อนอย่างยิ่งผ่านระบบ AI

4. การจำกัดความรับผิด (Limitation of Liability)

ระบบ MicroAI ให้บริการ "ตามสภาพที่เป็นอยู่" (As-Is) และ "ตามที่มีให้ใช้งาน" (As-Available) โดยไม่มีการรับประกันใดๆ ไม่ว่าโดยชัดแจ้งหรือโดยปริยาย รวมถึงการไม่รับประกันว่าระบบจะทำงานโดยไม่มีข้อผิดพลาดหรือไม่มีการหยุดชะงัก ผู้ให้บริการไม่ต้องรับผิดชอบต่อความสูญเสียทางธุรกิจ ข้อมูลที่สูญหาย หรือความเสียหายใดๆ ที่เกิดขึ้นจากการทำงานผิดพลาดของโมเดล AI ปลายทาง การล่าช้าของเครือข่าย หรือการสูญเสียการเข้าถึงบัญชี

Privacy Policy (นโยบายความเป็นส่วนตัว)

อัปเดตล่าสุด: 3 มิถุนายน 2026

MicroAI ให้ความสำคัญสูงสุดกับความเป็นส่วนตัวและความปลอดภัยของข้อมูลท่าน นโยบายความเป็นส่วนตัวฉบับนี้อธิบายถึงประเภทข้อมูลที่เราจัดเก็บ วิธีการประมวลผล การป้องกันความปลอดภัย และสิทธิ์ของท่านตามพระราชบัญญัติคุ้มครองข้อมูลส่วนบุคคล พ.ศ. 2562 (PDPA) และมาตรฐานสากล

1. ข้อมูลส่วนบุคคลที่เราจัดเก็บ

เมื่อท่านสมัครและใช้บริการของ MicroAI ระบบจะจัดเก็บข้อมูลเท่าที่จำเป็นดังต่อไปนี้:

• ข้อมูลบัญชีผู้ใช้: อีเมล (Email), ชื่อที่แสดง (Display Name), และหมายเลขรหัสประจำตัวผู้ใช้ (Firebase User UID)
• ข้อมูลการใช้งานและโควตา: จำนวนการเรียกใช้ API สะสม (aiUsed), ข้อมูลรุ่นโมเดลที่เลือกใช้งาน, และสถานะการสมัครใช้บริการ (Subscription Status)
• ข้อมูลบทเรียนและโปรเจกต์: System Prompts ประจำห้องสนทนา, รายชื่อและข้อมูลสรุปของไฟล์เอกสารอ้างอิง (Reference Files) ที่อัปโหลด และข้อมูลพิกัดเวกเตอร์แผนภาพแคนวาส (Scratchpad Canvas API Coordinates)
• ประวัติบทสนทนา (Chat History): ข้อความโต้ตอบระหว่างท่านกับ AI เพื่อจุดประสงค์ในการแสดงประวัติย้อนหลังในฝั่งผู้ใช้งาน

2. สรุปความปลอดภัยและสถาปัตยกรรมของฐานข้อมูล (Database Safety & Security)

นี่คือข้อมูลข้อเท็จจริงเชิงเทคนิคเกี่ยวกับความปลอดภัยของข้อมูลบนระบบฐานข้อมูลและโครงสร้างพื้นฐานของ MicroAI โดยไม่มีการโฆษณาเกินจริง (Strict Facts):

3. การแบ่งปันข้อมูลแก่บุคคลภายนอก (Data Sharing)

เราไม่มีการขายหรือเผยแพร่ข้อมูลส่วนบุคคลหรือข้อมูลการแชทของท่านให้แก่บริษัทโฆษณาหรือบุคคลภายนอกอื่นใด เพื่อผลประโยชน์ทางการค้า ข้อมูลจะถูกแชร์เฉพาะตามเงื่อนไขทางเทคนิคดังนี้:

• ผู้ให้บริการประมวลผล AI ปลายทาง: ข้อความสนทนาและบริบทจะถูกส่งต่อไปยังโมเดล (OpenAI, Gemini, DeepSeek) ผ่านช่องทางการสื่อสาร API ที่เข้ารหัสลับ โดยผู้ให้บริการเหล่านั้นมีพันธะสัญญาทางกฎหมายที่จะไม่นำข้อมูลของนักพัฒนาไปฝึกอบรมโมเดลต่อ
• การปฏิบัติตามกฎหมาย: เราอาจเปิดเผยข้อมูลส่วนบุคคลของท่านในกรณีที่มีหมายศาล คำสั่งจากหน่วยงานของรัฐที่ถูกต้องตามกฎหมาย หรือเพื่อป้องกันความเสียหายต่อสิทธิ์และทรัพย์สินส่วนรวม

4. สิทธิ์ของท่านในฐานะเจ้าของข้อมูลส่วนบุคคล (Your Rights)

ตามกฎหมาย PDPA ท่านมีสิทธิ์ในข้อมูลส่วนบุคคลของท่านดังนี้:

• สิทธิ์ในการเข้าถึงและขอสำเนา: ท่านสามารถตรวจสอบข้อมูลประวัติและข้อมูลโปรเจกต์ผ่านหน้าแผงควบคุมระบบได้ตลอดเวลา
• สิทธิ์ในการแก้ไขข้อมูลให้ถูกต้อง: ท่านสามารถแก้ไขโปรไฟล์ ชื่อโปรเจกต์ หรือ System prompt ได้ทันที
• สิทธิ์ในการขอให้ลบข้อมูล (Right to be Forgotten): ท่านสามารถลบห้องสนทนา ลบโปรเจกต์ หรือลบไฟล์อ้างอิงออกจากระบบได้ด้วยตนเอง ซึ่งข้อมูลดังกล่าวจะถูกลบออกจากฐานข้อมูลหลักในทันที
• สิทธิ์ในการยกเลิกบัญชีผู้ใช้: ท่านสามารถทำเรื่องขอยกเลิกบัญชีและขอให้ลบข้อมูลประวัติของท่านออกจากระบบทั้งหมดอย่างถาวรได้โดยการติดต่อฝ่ายสนับสนุนของเรา

5. การแจ้งเตือนกรณีข้อมูลรั่วไหล (Data Breach Notification)

แม้เราจะกำหนดมาตรการความปลอดภัยอย่างเข้มงวด แต่ไม่มีระบบฐานข้อมูลใดในโลกที่สามารถรับประกันความปลอดภัยได้ 100% หากเกิดเหตุการณ์สุดวิสัยเกี่ยวกับความปลอดภัยที่ส่งผลให้ข้อมูลส่วนบุคคลของท่านรั่วไหล เราจะดำเนินการตรวจสอบระงับเหตุทันที และทำการแจ้งเตือนแก่ผู้ใช้ที่ได้รับผลกระทบรวมถึงรายงานหน่วยงานกำกับดูแลที่เกี่ยวข้องภายใน 72 ชั่วโมง นับแต่ทราบเหตุตามข้อบังคับของกฎหมาย PDPA