Documentația API

POST/api/v1/run

Rulează o sarcină AI pe un text și returnează rezultatul ca text simplu (fără introducere, fără blocuri Markdown).

Cerere

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ro",
  "text": "Calitatea textului este foarte importantă pentru studenți.",
  "options": {}
}

Răspuns

Stare 200 cu ok: true, rezultatul în output, modelul care a răspuns efectiv în model (diferă când a intervenit un model de rezervă) și timpul de procesare în milisecunde. Se adaugă truncated: true când răspunsul a atins limita de lungime sau de timp și a fost tăiat.

{
  "ok": true,
  "output": "Calitatea redactării este esențială pentru studenți.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Exemplu: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"ro","text":"Ei sa dus la bibliotecă mâine."}'

Exemplu: 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: 'ro', 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

Alege 4–8 expresii distinctive din text, le caută în surse deschise în limba textului (Wikipedia, Wikisource, textul integral Internet Archive, Europe PMC, DOAJ, arXiv; un furnizor de căutare web doar dacă este configurat și solicitat) și calculează suprapunerea. Doar acele expresii scurte ies de pe server.

Cerere

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

{ "text": "…cel puțin 30 de cuvinte…", "lang": "ro", "options": { "web": false } }

Răspuns

Stare 200 cu score (cuvinte potrivite ÷ cuvinte, 0–1), matches pe surse, cu passages evidențiate (poziții de caractere în textul tău), sourcesSearched (exact sursele ale căror răspunsuri sunt în rezultat), sourcesSkipped cu motivul și webSearched.

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

Exemplu: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"ro","text":"…cel puțin 30 de cuvinte…"}'

GET/api/v1/health

Arată ce servicii sunt pornite. Nu primește corp de cerere și nu se numără în cotă.

Răspuns

Stare 200. ai este false cât timp comutatorul de oprire a AI este activ; plagiarism enumeră sursele pe care verificatorul le poate interoga; aidetect descrie analiza aprofundată de pe server a detectorului AI, care nu este încă lansată (POST /api/v1/aidetect răspunde 503 disabled; detectorul de pe site rulează în browserul tău).

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

Exemplu: curl

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

Task list