API ডকুমেন্টেশন

POST/api/v1/run

একটি লেখার ওপর একটি এআই কাজ চালায় এবং ফলাফল সাদা টেক্সট হিসেবে ফেরত দেয় (ভূমিকা-বাক্য বা Markdown ব্লক ছাড়া)।

অনুরোধ

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "bn",
  "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":"bn","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: 'bn', 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

লেখা থেকে ৪–৮টি বৈশিষ্ট্যপূর্ণ বাক্যাংশ বেছে নেয়, লেখার ভাষার উন্মুক্ত উৎসে (উইকিপিডিয়া, উইকিসোর্স, ইন্টারনেট আর্কাইভের পূর্ণ পাঠ, Europe PMC, DOAJ, arXiv; ওয়েব সার্চ সরবরাহকারী শুধু কনফিগার করা থাকলে এবং চাইলে) খোঁজে এবং মিলের হিসাব দেয়। সার্ভার থেকে কেবল ওই ছোট বাক্যাংশগুলোই বাইরে যায়।

অনুরোধ

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

{ "text": "…কমপক্ষে ৩০ শব্দ…", "lang": "bn", "options": { "web": false } }

উত্তর

স্ট্যাটাস 200, সঙ্গে score (মিলে যাওয়া শব্দ ÷ মোট শব্দ, ০–১), উৎস ধরে matches ও হাইলাইট করা passages (আপনার লেখার অক্ষর-অবস্থান), sourcesSearched (যেসব উৎসের উত্তর ফলাফলে ঢুকেছে ঠিক সেগুলো), কারণসহ sourcesSkipped এবং webSearched।

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://bn.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":"bn","text":"…কমপক্ষে ৩০ শব্দ…"}'

GET/api/v1/health

কোন সেবাগুলো চালু আছে তা জানায়। কোনো বডি লাগে না এবং কোটায় গণনা হয় না।

উত্তর

স্ট্যাটাস 200। এআই কিল সুইচ চালু থাকলে ai false হয়; plagiarism চেকার কোন কোন উৎস খুঁজতে পারে তার তালিকা দেয়; aidetect এআই ডিটেক্টরের সার্ভারভিত্তিক গভীর বিশ্লেষণের অবস্থা জানায়, যা এখনো চালু হয়নি (POST /api/v1/aidetect উত্তর দেয় 503 disabled; সাইটের ডিটেক্টর আপনার ব্রাউজারেই চলে)।

{
  "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