API दस्तावेज़

POST/api/v1/run

पाठ पर एक AI टास्क चलाता है और नतीजा सादे पाठ के रूप में लौटाता है (न भूमिका, न Markdown के कोड-ब्लॉक)।

अनुरोध

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

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