API ഡോക്യുമെന്റേഷൻ

POST/api/v1/run

ഒരു ടെക്സ്റ്റിൽ ഒരു AI ടാസ്ക് പ്രവർത്തിപ്പിച്ച് ഫലം സാധാരണ ടെക്സ്റ്റായി (മുഖവുരയില്ല, Markdown ഫെൻസുകളില്ല) നൽകുന്നു.

അഭ്യർഥന

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ml",
  "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":"ml","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: 'ml', 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": "ml", "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://ml.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":"ml","text":"…കുറഞ്ഞത് 30 വാക്ക്…"}'

GET/api/v1/health

ഏതെല്ലാം സേവനങ്ങൾ ഓണാണെന്ന് അറിയിക്കുന്നു. ബോഡി ആവശ്യമില്ല, ക്വോട്ടയിൽ കണക്കാക്കുകയുമില്ല.

പ്രതികരണം

സ്റ്റാറ്റസ് 200. AI കിൽ സ്വിച്ച് ഓണായിരിക്കുമ്പോൾ ai false ആയിരിക്കും; plagiarism ചെക്കറിന് തിരയാവുന്ന സ്രോതസ്സുകൾ പട്ടികപ്പെടുത്തുന്നു; AI ഡിറ്റക്ടറിന്റെ സെർവർ വശത്തെ ആഴത്തിലുള്ള വിശകലനത്തെ 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