Dokumentasyon ng API

POST/api/v1/run

Nagpapatakbo ng isang gawain ng AI sa isang teksto at ibinabalik ang resulta bilang plain text (walang paunang salita, walang Markdown fence).

Kahilingan

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "tl",
  "text": "Mahalaga ang mahusay na pagsulat para sa mga estudyante.",
  "options": {}
}

Tugon

Status 200 na may ok: true, ang resulta sa output, ang model na talagang sumagot sa model (iba ito kapag pumasok ang fallback model) at ang oras ng pagproseso sa millisecond. Idinaragdag ang truncated: true kapag naabot ng sagot ang hangganan ng haba nito o ang time limit at pinutol ito.

{
  "ok": true,
  "output": "Napakahalaga ng mahusay na pagsulat sa mga estudyante.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Halimbawa: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"tl","text":"Pupunta ako sa aklatan bukas ng umaga."}'

Halimbawa: 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: 'tl', 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

Pumipili ng 4–8 natatanging parirala mula sa teksto, naghahanap sa mga bukas na sanggunian sa wika ng teksto (Wikipedia, Wikisource, buong teksto ng Internet Archive, Europe PMC, DOAJ, arXiv; isang web search provider lamang kapag naka-configure at hiniling) at tinutuos ang pagkakapareho. Ang mga maiikling pariralang iyon lamang ang lumalabas sa server.

Kahilingan

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

{ "text": "…hindi bababa sa 30 salita…", "lang": "tl", "options": { "web": false } }

Tugon

Status 200 na may score (tugmang salita ÷ salita, 0–1), matches kada sanggunian na may naka-highlight na passages (mga character offset sa teksto mo), sourcesSearched (eksaktong mga sanggunian na ang sagot ay nasa resulta), sourcesSkipped na may dahilan, at webSearched.

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://tl.wikipedia.org/wiki/…",
                "matchedWords": 22, "passages": [{ "start": 0, "end": 131, "text": "…" }] }],
  "sourcesSearched": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj"],
  "sourcesSkipped": [],
  "webSearched": false,
  "ms": 2310
}

Halimbawa: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"tl","text":"…hindi bababa sa 30 salita…"}'

GET/api/v1/health

Iniuulat kung aling mga serbisyo ang naka-on. Walang body at hindi binibilang sa quota.

Tugon

Status 200. Ang ai ay false habang naka-on ang AI kill switch; inililista ng plagiarism ang mga sanggunian na maaaring tanungin ng checker; inilalarawan ng aidetect ang server-side na malalimang pagsusuri ng AI detector, na hindi pa naka-deploy (sumasagot ang POST /api/v1/aidetect ng 503 disabled; sa browser mo tumatakbo ang detector sa site).

{
  "ok": true,
  "ai": true,
  "plagiarism": { "enabled": true, "sources": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj", "arxiv"], "web": false },
  "aidetect": { "enabled": false, "judge": false }
}

Halimbawa: curl

curl https://adeptwrite.com/api/v1/health

Task list