API-dokumentasie

POST/api/v1/run

Voer een KI-taak op ’n teks uit en gee die resultaat as gewone teks terug (geen voorwoord, geen Markdown-omheining nie).

Versoek

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "af",
  "text": "Goeie skryfwerk is baie belangrik vir studente.",
  "options": {}
}

Antwoord

Status 200 met ok: true, die resultaat in output, die model wat werklik geantwoord het in model (dit verskil wanneer ’n terugvalmodel ingespring het) en die verwerkingstyd in millisekondes. truncated: true word bygevoeg wanneer die antwoord sy lengtebegroting of tydsgrens bereik het en afgesny is.

{
  "ok": true,
  "output": "Goeie skryfwerk is vir studente van groot belang.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Voorbeeld: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"af","text":"Hulle gaan more na die biblioteek toe."}'

Voorbeeld: 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: 'af', 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

Kies 4–8 kenmerkende frases uit die teks, deursoek oop bronne in die tekstaal (Wikipedia, Wikisource, Internet Archive-volteks, Europe PMC, DOAJ, arXiv; ’n websoekverskaffer net wanneer dit opgestel en gevra is) en bereken die oorvleueling. Slegs daardie kort frases verlaat die bediener.

Versoek

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

{ "text": "…minstens 30 woorde…", "lang": "af", "options": { "web": false } }

Antwoord

Status 200 met score (ooreenstemmende woorde ÷ woorde, 0–1), matches per bron met uitgeligte passages (karakterposisies in jou teks), sourcesSearched (presies die bronne wie se antwoorde in die resultaat is), sourcesSkipped met ’n rede, en webSearched.

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

Voorbeeld: curl

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

GET/api/v1/health

Meld watter dienste aangeskakel is. Neem geen liggaam nie en tel nie teen die kwota nie.

Antwoord

Status 200. ai is false terwyl die KI-afskakelaar aan is; plagiarism lys die bronne wat die toetser kan navraag doen; aidetect beskryf die bedienerkantse diepontleding van die KI-verklikker, wat nog nie ontplooi is nie (POST /api/v1/aidetect antwoord 503 disabled; die verklikker op die werf loop in jou blaaier).

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

Voorbeeld: curl

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

Task list