Dokumentacija API

POST/api/v1/run

Izvede eno nalogo z UI nad besedilom in vrne rezultat kot navadno besedilo (brez uvoda in brez Markdownovih ograd).

Zahteva

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "sl",
  "text": "Dobro pisanje je za študente zelo pomembno.",
  "options": {}
}

Odgovor

Stanje 200 z ok: true, rezultat v output, model, ki je dejansko odgovoril, v model (ta se razlikuje, kadar je priskočil nadomestni model), in čas obdelave v milisekundah. Polje truncated: true se doda, kadar je odgovor dosegel omejitev dolžine ali časa in je bil odrezan.

{
  "ok": true,
  "output": "Kakovostno pisanje je za študente bistvenega pomena.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Primer: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"sl","text":"Šel sem z prijateljem v Ljubljano in nevem, kdaj se vrnem."}'

Primer: 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: 'sl', 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

Izbere 4–8 značilnih besednih zvez iz besedila, v jeziku besedila poišče po odprtih virih (Wikipedija, Wikisource, polno besedilo Internet Archive, Europe PMC, DOAJ, arXiv; ponudnik spletnega iskanja samo, če je nastavljen in zahtevan) in oceni prekrivanje. Strežnik zapustijo samo te kratke besedne zveze.

Zahteva

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

{ "text": "…vsaj 30 besed…", "lang": "sl", "options": { "web": false } }

Odgovor

Stanje 200 s poljem score (ujemajoče se besede ÷ besede, 0–1), matches po virih z označenimi odlomki v passages (zamiki znakov v vašem besedilu), sourcesSearched (natanko viri, katerih odgovori so v rezultatu), sourcesSkipped z razlogom in webSearched.

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

Primer: curl

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

GET/api/v1/health

Sporoča, katere storitve so vklopljene. Ne sprejme telesa in se ne všteva v kvoto.

Odgovor

Stanje 200. Polje ai je false, dokler je vklopljeno zasilno stikalo UI; plagiarism našteje vire, ki jih preverjanje lahko poizveduje; aidetect opisuje strežniško poglobljeno analizo AI detektorja, ki še ni nameščena (POST /api/v1/aidetect odgovori 503 disabled; detektor na strani deluje v vašem brskalniku).

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

Primer: curl

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

Task list