API-dokumentation

POST/api/v1/run

Kører én AI-opgave på en tekst og returnerer resultatet som ren tekst (uden indledning og uden Markdown-kodeblokke).

Forespørgsel

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "da",
  "text": "God skrivning er vigtig for studerende.",
  "options": {}
}

Svar

Status 200 med ok: true, resultatet i output, den model, der faktisk svarede, i model (den er en anden, hvis en reservemodel trådte til) og behandlingstiden i millisekunder. truncated: true tilføjes, når svaret ramte sit længdebudget eller tidsgrænsen og blev afbrudt.

{
  "ok": true,
  "output": "Kvaliteten af skriftligt arbejde er afgørende for studerende.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Eksempel: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"da","text":"Jeg skal lave noget mad og går en tur."}'

Eksempel: 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: 'da', 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

Vælger 4–8 karakteristiske sætningsdele fra teksten, søger i åbne kilder på tekstens sprog (Wikipedia, Wikisource, Internet Archive fuldtekst, Europe PMC, DOAJ, arXiv; en websøgetjeneste kun hvis den er sat op og efterspurgt) og beregner overlappet. Kun de korte sætningsdele forlader serveren.

Forespørgsel

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

{ "text": "…mindst 30 ord…", "lang": "da", "options": { "web": false } }

Svar

Status 200 med score (matchende ord ÷ ord, 0–1), matches pr. kilde med markerede passages (tegnpositioner i din tekst), sourcesSearched (præcis de kilder, hvis svar indgår i resultatet), sourcesSkipped med en begrundelse og webSearched. Scoren er et mål for ligheden med åbne kilder, ikke et bevis for plagiat.

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

Eksempel: curl

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

GET/api/v1/health

Melder, hvilke tjenester der er slået til. Tager ingen body og tæller ikke med i kvoten.

Svar

Status 200. ai er false, mens AI-nødafbryderen er slået til; plagiarism viser de kilder, plagiattjekket kan spørge; aidetect beskriver den dybere analyse på serversiden i AI-tjekkeren, som endnu ikke er udrullet (POST /api/v1/aidetect svarer 503 disabled; AI-tjekkeren på siden kører i din browser).

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

Eksempel: curl

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

Task list