API दस्तऐवज

POST/api/v1/run

मजकुरावर एक AI काम चालवतो आणि निकाल साधा मजकूर म्हणून देतो (प्रस्तावनेशिवाय, Markdown ब्लॉकशिवाय).

विनंती

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

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

मजकुरातील ४–८ वैशिष्ट्यपूर्ण वाक्यांश निवडतो, मजकुराच्या भाषेतील मुक्त स्रोतांमध्ये (Wikipedia, Wikisource, Internet Archive पूर्ण मजकूर, Europe PMC, DOAJ, arXiv; वेब शोध पुरवठादार फक्त कॉन्फिगर केलेला असेल आणि मागितला असेल तेव्हा) शोधतो आणि साम्याचे गुण देतो. फक्त ते छोटे वाक्यांश सर्व्हरबाहेर जातात.

विनंती

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

{ "text": "…किमान ३० शब्द…", "lang": "mr", "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://mr.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":"mr","text":"…किमान ३० शब्द…"}'

GET/api/v1/health

कोणत्या सेवा सुरू आहेत ते सांगतो. त्यात body नसतो आणि तो कोट्यात मोजला जात नाही.

प्रतिसाद

स्टेटस 200. AI kill switch चालू असताना ai हे false असते; plagiarism तपासणी ज्या स्रोतांना विचारू शकते त्यांची यादी देते; aidetect हे AI डिटेक्टरच्या सर्व्हर-बाजूच्या सखोल विश्लेषणाचे वर्णन करते, जे अजून तैनात केलेले नाही (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