תיעוד ה־API

POST/api/v1/run

מריצה משימת בינה מלאכותית אחת על טקסט ומחזירה את התוצאה כטקסט פשוט (בלי פתיח ובלי גדרות Markdown).

בקשה

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

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