เอกสาร API

POST/api/v1/run

รันงาน AI หนึ่งงานกับข้อความและคืนผลลัพธ์เป็นข้อความธรรมดา (ไม่มีคำนำ ไม่มีเครื่องหมายครอบโค้ด Markdown)

คำขอ

POST /api/v1/run HTTP/1.1
Content-Type: application/json

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "th",
  "text": "การเขียนที่ดีมีความสำคัญต่อนักศึกษามาก",
  "options": {}
}

การตอบกลับ

สถานะ 200 พร้อม ok: true ผลลัพธ์ใน output โมเดลที่ตอบจริงใน model (ต่างออกไปเมื่อโมเดลสำรองเข้ามาแทน) และเวลาประมวลผลเป็นมิลลิวินาที จะเพิ่ม truncated: true เมื่อคำตอบถึงงบความยาวหรือเวลาจำกัดแล้วถูกตัด

{
  "ok": true,
  "output": "คุณภาพของงานเขียนเป็นสิ่งสำคัญสำหรับนักศึกษา",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

ตัวอย่าง: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"th","text":"ฉันไปห้องสมุดพรุ่งนี้เช้า"}'

ตัวอย่าง: JavaScript (fetch)

const res = await fetch('/api/v1/run', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ task: 'summarize', mode: 'Poin-poin', lang: 'th', text }),
});
const data = await res.json();
if (!data.ok) throw new Error(data.error.code + ': ' + data.error.message);
console.log(data.output);

POST/api/v1/plagiarism

เลือกวลีเด่น 4–8 วลีจากข้อความ ค้นในแหล่งข้อมูลเปิดตามภาษาของข้อความ (Wikipedia, Wikisource, ข้อความเต็มของ Internet Archive, Europe PMC, DOAJ, arXiv และผู้ให้บริการค้นเว็บเฉพาะเมื่อมีการตั้งค่าและร้องขอ) แล้วให้คะแนนส่วนที่ทับซ้อน มีเพียงวลีสั้นเหล่านั้นที่ออกจากเซิร์ฟเวอร์

คำขอ

POST /api/v1/plagiarism HTTP/1.1
Content-Type: application/json

{ "text": "…อย่างน้อย 30 คำ…", "lang": "th", "options": { "web": false } }

การตอบกลับ

สถานะ 200 พร้อม score (คำที่ตรง ÷ จำนวนคำ ค่า 0–1) matches แยกตามแหล่งพร้อม passages ที่ไฮไลต์ (ตำแหน่งตัวอักษรในข้อความของคุณ) sourcesSearched (ตรงกับแหล่งที่คำตอบอยู่ในผลลัพธ์เท่านั้น) sourcesSkipped พร้อมเหตุผล และ webSearched

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://th.wikipedia.org/wiki/…",
                "matchedWords": 22, "passages": [{ "start": 0, "end": 131, "text": "…" }] }],
  "sourcesSearched": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj"],
  "sourcesSkipped": [],
  "webSearched": false,
  "ms": 2310
}

ตัวอย่าง: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"th","text":"…อย่างน้อย 30 คำ…"}'

GET/api/v1/health

รายงานว่าบริการใดเปิดอยู่ ไม่มีเนื้อหาคำขอ และไม่นับรวมในโควตา

การตอบกลับ

สถานะ 200 ai เป็น false เมื่อสวิตช์ปิด AI ทำงานอยู่ plagiarism แสดงแหล่งที่เครื่องมือตรวจค้นได้ aidetect อธิบายการวิเคราะห์เชิงลึกฝั่งเซิร์ฟเวอร์ของเครื่องมือตรวจจับ AI ซึ่งยังไม่เปิดใช้ (POST /api/v1/aidetect ตอบ 503 disabled ส่วนเครื่องมือตรวจจับ AI บนเว็บไซต์ทำงานในเบราว์เซอร์ของคุณ)

{
  "ok": true,
  "ai": true,
  "plagiarism": { "enabled": true, "sources": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj", "arxiv"], "web": false },
  "aidetect": { "enabled": false, "judge": false }
}

ตัวอย่าง: curl

curl https://adeptwrite.com/api/v1/health

Task list