Dokumentácia API

POST/api/v1/run

Spustí jednu úlohu AI nad textom a vráti výsledok ako čistý text (bez úvodu a bez blokov Markdownu).

Požiadavka

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "sk",
  "text": "Kvalita písania je pre vysokoškolských študentov veľmi dôležitá.",
  "options": {}
}

Odpoveď

Stav 200 s ok: true, výsledkom v output, modelom, ktorý skutočne odpovedal, v model (líši sa, ak prevzal záložný model) a trvaním spracovania v milisekundách. Ak bola odpoveď useknutá pre dosiahnutý limit dĺžky alebo času, pribudne truncated: true.

{
  "ok": true,
  "output": "Kvalita textu je pre vysokoškolákov mimoriadne dôležitá.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Príklad: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"sk","text":"Zajtra sa stretneme zo mnou v škole."}'

Príklad: 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: 'sk', 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

Vyberie 4 až 8 charakteristických fráz z textu, vyhľadá ich v otvorených zdrojoch podľa jazyka textu (Wikipédia, Wikisource, plné texty Internet Archive, Europe PMC, DOAJ, arXiv; poskytovateľ webového vyhľadávania len ak je nakonfigurovaný a vyžiadaný) a vypočíta mieru zhody. Zo servera odchádzajú iba tieto krátke frázy.

Požiadavka

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

{ "text": "…aspoň 30 slov…", "lang": "sk", "options": { "web": false } }

Odpoveď

Stav 200 s score (zhodujúce sa slová ÷ počet slov, 0 až 1), matches podľa zdrojov so zvýraznenými passages (pozície znakov vo vašom texte), sourcesSearched (presne tie zdroje, ktorých odpoveď je vo výsledku), sourcesSkipped s dôvodmi a webSearched.

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

Príklad: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"sk","text":"…aspoň 30 slov…"}'

GET/api/v1/health

Hlási, ktoré služby bežia. Nevyžaduje telo požiadavky a nezapočítava sa do kvót.

Odpoveď

Stav 200. ai je false, kým je zapnutý núdzový vypínač AI; plagiarism uvádza zdroje, ktoré kontrola vie prehľadávať; aidetect opisuje hĺbkovú analýzu AI detektora na serveri, ktorá zatiaľ nie je nasadená (POST /api/v1/aidetect odpovie 503 disabled; detektor na webe beží vo vašom prehliadači).

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

Príklad: curl

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

Task list