مستندات رابط برنامه‌نویسی

POST/api/v1/run

یک کار هوش مصنوعی را روی یک متن اجرا می‌کند و نتیجه را به‌صورت متن ساده برمی‌گرداند (بدون مقدمه و بدون پرچین‌های Markdown).

درخواست

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "fa",
  "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":"fa","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: 'fa', 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

از متن ۴ تا ۸ عبارت متمایز برمی‌گزیند، منابع باز به زبان متن را جست‌وجو می‌کند (Wikipedia، Wikisource، متن کامل Internet Archive، Europe PMC، DOAJ، arXiv؛ و فقط وقتی پیکربندی و درخواست شده باشد، یک سرویس جست‌وجوی وب) و میزان هم‌پوشانی را نمره می‌دهد. فقط همان عبارت‌های کوتاه از سرور بیرون می‌روند. پایگاه‌های ایرانی مانند همانندجو جست‌وجو نمی‌شوند.

درخواست

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

{ "text": "…دست‌کم ۳۰ کلمه…", "lang": "fa", "options": { "web": false } }

پاسخ

وضعیت 200 با score (کلمه‌های منطبق ÷ کلمه‌ها، از ۰ تا ۱)، matches برای هر منبع با passages نشانه‌گذاری‌شده (جابه‌جایی نویسه‌ای در متن شما)، sourcesSearched (دقیقاً منابعی که پاسخشان در نتیجه هست)، sourcesSkipped با دلیل و webSearched. نمره تخمین هم‌پوشانی با منابع باز است، نه حکم سرقت ادبی.

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://fa.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":"fa","text":"…دست‌کم ۳۰ کلمه…"}'

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