API డాక్యుమెంటేషన్

POST/api/v1/run

ఒక టెక్స్ట్ మీద ఒక AI పనిని నడిపి ఫలితాన్ని సాదా టెక్స్ట్‌గా ఇస్తుంది (ముందుమాట లేదు, Markdown ఫెన్స్‌లు లేవు).

అభ్యర్థన

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "te",
  "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":"te","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: 'te', 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": "te", "options": { "web": false } }

స్పందన

స్టేటస్ 200; score (సరిపోలిన పదాలు ÷ పదాలు, 0–1), ప్రతి మూలానికి హైలైట్ చేసిన passages (మీ టెక్స్ట్‌లో అక్షర ఆఫ్‌సెట్లు) ఉన్న matches, sourcesSearched (జవాబులు ఫలితంలో ఉన్న మూలాలు మాత్రమే), కారణంతో sourcesSkipped, webSearched ఇస్తుంది.

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://te.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":"te","text":"…కనీసం 30 పదాలు…"}'

GET/api/v1/health

ఏ సేవలు ఆన్‌లో ఉన్నాయో చెబుతుంది. బాడీ అవసరం లేదు, కోటాలో లెక్కకు రాదు.

స్పందన

స్టేటస్ 200. AI కిల్ స్విచ్ ఆన్‌లో ఉన్నప్పుడు 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