Документація API

POST/api/v1/run

Виконує одне ШІ-завдання над текстом і повертає результат звичайним текстом (без вступу й без блоків коду Markdown).

Запит

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "uk",
  "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":"uk","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: 'uk', 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 характерних фраз із тексту, шукає їх у відкритих джерелах мовою тексту (Вікіпедія, Вікіджерела, повний текст Internet Archive, Europe PMC, DOAJ, arXiv; постачальник вебпошуку — лише якщо його налаштовано й запитано) та оцінює збіг. Сервер залишають тільки ці короткі фрази.

Запит

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

{ "text": "…не менше 30 слів…", "lang": "uk", "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://uk.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":"uk","text":"…не менше 30 слів…"}'

GET/api/v1/health

Повідомляє, які сервіси ввімкнено. Не має тіла запиту й не зараховується до квоти.

Відповідь

Статус 200. Поле ai дорівнює false, поки ввімкнено аварійний вимикач ШІ; plagiarism перелічує джерела, які може опитувати перевірка; aidetect описує серверний глибокий аналіз детектора ШІ, який ще не розгорнуто (POST /api/v1/aidetect відповідає 503 disabled; детектор на сайті працює у вашому браузері).

{
  "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