API документация

POST/api/v1/run

Изпълнява една задача с ИИ върху текст и връща резултата като обикновен текст (без встъпление и без Markdown огради).

Заявка

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "bg",
  "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":"bg","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: 'bg', 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 характерни фрази от текста, търси в отворени източници на езика на текста (Уикипедия, Wikisource, пълен текст на Internet Archive, Europe PMC, DOAJ, arXiv; доставчик на уеб търсене само когато е настроен и поискан) и оценява припокриването. Само тези кратки фрази напускат сървъра.

Заявка

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

{ "text": "…поне 30 думи…", "lang": "bg", "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://bg.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":"bg","text":"…поне 30 думи…"}'

GET/api/v1/health

Съобщава кои услуги са включени. Не приема тяло и не се брои към квотата.

Отговор

Статус 200. ai е false, докато аварийният изключвател на ИИ е включен; plagiarism изброява източниците, които проверката може да заяви; aidetect описва сървърния задълбочен анализ на AI детектора, който още не е внедрен (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