API-Dokumentation

POST/api/v1/run

Führt eine KI-Aufgabe auf einem Text aus und gibt das Ergebnis als Klartext zurück (ohne Vorrede, ohne Markdown-Zäune).

Anfrage

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "de",
  "text": "Gutes Schreiben ist für Studierende wirklich wichtig.",
  "options": {}
}

Antwort

Status 200 mit ok: true, dem Ergebnis in output, dem Modell, das tatsächlich geantwortet hat, in model (es weicht ab, wenn ein Ausweichmodell eingesprungen ist), und der Verarbeitungszeit in Millisekunden. truncated: true kommt hinzu, wenn die Antwort ihr Längenbudget oder das Zeitlimit erreicht hat und abgeschnitten wurde.

{
  "ok": true,
  "output": "Die Qualität des Schreibens ist für Studierende von zentraler Bedeutung.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Beispiel: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"de","text":"Wir treffen uns morgen in der Bibliotek, dann schreibe ich die Hausarbeit zuende."}'

Beispiel: 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: 'de', 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

Wählt 4–8 markante Wortfolgen aus dem Text, durchsucht offene Quellen in der Sprache des Textes (Wikipedia, Wikisource, Volltext des Internet Archive, Europe PMC, DOAJ, arXiv; einen Websuch-Anbieter nur, wenn er eingerichtet ist und angefragt wird) und bewertet die Übereinstimmung. Nur diese kurzen Wortfolgen verlassen den Server.

Anfrage

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

{ "text": "…mindestens 30 Wörter…", "lang": "de", "options": { "web": false } }

Antwort

Status 200 mit score (übereinstimmende Wörter ÷ Wörter, 0–1), matches je Quelle mit markierten passages (Zeichenpositionen in Ihrem Text), sourcesSearched (genau die Quellen, deren Antworten im Ergebnis stehen), sourcesSkipped mit Begründung und webSearched.

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

Beispiel: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"de","text":"…mindestens 30 Wörter…"}'

GET/api/v1/health

Meldet, welche Dienste eingeschaltet sind. Braucht keinen Body und zählt nicht auf das Kontingent.

Antwort

Status 200. ai ist false, solange der KI-Notschalter aktiv ist; plagiarism listet die Quellen, die die Prüfung abfragen kann; aidetect beschreibt die serverseitige Tiefenanalyse des KI-Detektors, die noch nicht bereitgestellt ist (POST /api/v1/aidetect antwortet mit 503 disabled; der Detektor auf der Website läuft in Ihrem Browser).

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

Beispiel: curl

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

Task list