API-dokumentáció

POST/api/v1/run

Egy MI-feladatot hajt végre a szövegen, és az eredményt sima szövegként adja vissza (bevezető mondat és Markdown-blokk nélkül).

Kérés

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "hu",
  "text": "Az írás minősége nagyon fontos az egyetemistáknak.",
  "options": {}
}

Válasz

200 állapotkód ok: true értékkel, az eredmény az output mezőben, a ténylegesen válaszoló modell a model mezőben (eltér, ha tartalék modell vette át a feladatot), és a feldolgozás ideje ezredmásodpercben. A truncated: true mező akkor jelenik meg, ha a választ a hosszkorlát vagy az időkorlát megszakította.

{
  "ok": true,
  "output": "A szöveg színvonala kiemelten fontos a hallgatók számára.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Példa: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"hu","text":"Tegnap Péterel busszal mentem a egyetemre."}'

Példa: 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: 'hu', 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

A szövegből 4–8 jellegzetes kifejezést választ ki, megkeresi őket a szöveg nyelvének megfelelő nyílt forrásokban (Wikipédia, Wikiforrás, az Internet Archive teljes szövegei, Europe PMC, DOAJ, arXiv; webes keresőszolgáltató csak akkor, ha be van állítva és kérték), majd kiszámítja az átfedést. Csak ezek a rövid kifejezések hagyják el a szervert.

Kérés

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

{ "text": "…legalább 30 szó…", "lang": "hu", "options": { "web": false } }

Válasz

200 állapotkód a score (az egyező szavak ÷ az összes szó, 0–1), forrásonkénti matches a kiemelt passages szakaszokkal (karakterpozíciók a szövegedben), a sourcesSearched (pontosan azok a források, amelyek válasza benne van az eredményben), a sourcesSkipped az okokkal, és a webSearched mezőkkel.

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

Példa: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"hu","text":"…legalább 30 szó…"}'

GET/api/v1/health

Megmutatja, mely szolgáltatások működnek. Nincs kérés törzse, és nem számít bele a keretbe.

Válasz

200 állapotkód. Az ai értéke false, amíg az MI vészkapcsolója be van kapcsolva; a plagiarism felsorolja a keresőnek elérhető forrásokat; az aidetect az AI-detektor szerveroldali mélyelemzését írja le, amely még nincs telepítve (a POST /api/v1/aidetect 503 disabled választ ad; az oldalon az AI-detektor a böngészőben fut).

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

Példa: curl

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

Task list