Τεκμηρίωση API

POST/api/v1/run

Εκτελεί μία εργασία AI σε ένα κείμενο και επιστρέφει το αποτέλεσμα ως απλό κείμενο (χωρίς προοίμιο, χωρίς μπλοκ Markdown).

Αίτημα

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "el",
  "text": "Η καλή γραφή είναι πολύ σημαντική για τους φοιτητές.",
  "options": {}
}

Απάντηση

Κατάσταση 200 με ok: true, το αποτέλεσμα στο output, το μοντέλο που απάντησε πραγματικά στο model (διαφέρει όταν παρεμβαίνει εφεδρικό μοντέλο) και τον χρόνο επεξεργασίας σε χιλιοστά του δευτερολέπτου. Το truncated: true προστίθεται όταν η απάντηση έφτασε στο όριο μήκους ή χρόνου και κόπηκε.

{
  "ok": true,
  "output": "Η ποιότητα της γραφής είναι ουσιώδης για τους φοιτητές.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Παράδειγμα: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"el","text":"Θα πάμε αύριο στην βιβλιοθήκη."}'

Παράδειγμα: 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: 'el', 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

Επιλέγει 4–8 χαρακτηριστικές φράσεις από το κείμενο, αναζητά σε ανοιχτές πηγές στη γλώσσα του κειμένου (Wikipedia, Wikisource, πλήρες κείμενο Internet Archive, Europe PMC, DOAJ, arXiv· πάροχο αναζήτησης ιστού μόνο όταν έχει ρυθμιστεί και ζητηθεί) και βαθμολογεί την επικάλυψη. Μόνο αυτές οι σύντομες φράσεις φεύγουν από τον διακομιστή.

Αίτημα

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

{ "text": "…τουλάχιστον 30 λέξεις…", "lang": "el", "options": { "web": false } }

Απάντηση

Κατάσταση 200 με score (λέξεις που ταιριάζουν ÷ λέξεις, 0–1), matches ανά πηγή με επισημασμένα passages (θέσεις χαρακτήρων στο κείμενό σας), sourcesSearched (ακριβώς οι πηγές των οποίων οι απαντήσεις περιλαμβάνονται στο αποτέλεσμα), sourcesSkipped με αιτιολογία και webSearched.

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

Παράδειγμα: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"el","text":"…τουλάχιστον 30 λέξεις…"}'

GET/api/v1/health

Αναφέρει ποιες υπηρεσίες είναι ενεργές. Δεν έχει σώμα και δεν προσμετράται στην ποσόστωση.

Απάντηση

Κατάσταση 200. Το ai είναι false όσο ο διακόπτης έκτακτης ανάγκης του AI είναι ενεργός· το plagiarism απαριθμεί τις πηγές που μπορεί να ρωτήσει ο έλεγχος· το aidetect περιγράφει τη βαθύτερη ανάλυση του ανιχνευτή AI στον διακομιστή, η οποία δεν έχει ακόμη αναπτυχθεί (το POST /api/v1/aidetect απαντά 503 disabled· ο ανιχνευτής του ιστότοπου τρέχει στον browser σας).

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

Παράδειγμα: curl

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

Task list