API दस्तावेज

POST/api/v1/run

पाठमा एउटा एआई काम चलाउँछ र नतिजा सादा पाठका रूपमा फर्काउँछ (भूमिका वाक्य र Markdown बाड बिना)।

अनुरोध

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ne",
  "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":"ne","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: 'ne', 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, Internet Archive को पूर्ण पाठ, Europe PMC, DOAJ, arXiv; वेब खोज प्रदायक सेट गरिएको र माग गरिएको अवस्थामा मात्र) मा खोज्छ र मिलानको स्कोर निकाल्छ। ती छोटा वाक्यांश मात्र सर्भरबाट बाहिर जान्छन्।

अनुरोध

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

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

GET/api/v1/health

कुन सेवा सक्रिय छन् भनेर बताउँछ। कुनै body लिँदैन र कोटामा गनिँदैन।

प्रतिक्रिया

स्थिति 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