Tài liệu API

POST/api/v1/run

Chạy một tác vụ AI trên văn bản và trả kết quả dạng văn bản thuần (không lời dẫn, không khung mã Markdown).

Yêu cầu

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "vi",
  "text": "Viết tốt thật sự quan trọng với sinh viên.",
  "options": {}
}

Phản hồi

Trạng thái 200 với ok: true, kết quả trong output, mô hình thực sự đã trả lời trong model (khác đi khi một mô hình dự phòng thay thế) và thời gian xử lý tính bằng mili giây. truncated: true được thêm vào khi câu trả lời chạm giới hạn độ dài hoặc thời gian và bị cắt.

{
  "ok": true,
  "output": "Kỹ năng viết có vai trò thiết yếu đối với sinh viên.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Ví dụ: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"vi","text":"Chúng tôi sẽ gữi báo cáo vào ngày mai."}'

Ví dụ: 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: 'vi', 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

Chọn 4–8 cụm từ đặc trưng trong văn bản, tìm chúng trong các nguồn mở theo ngôn ngữ của văn bản (Wikipedia, Wikisource, toàn văn Internet Archive, Europe PMC, DOAJ, arXiv; nhà cung cấp tìm kiếm web chỉ khi được cấu hình và được yêu cầu) rồi chấm mức trùng lặp. Chỉ những cụm từ ngắn đó rời khỏi máy chủ.

Yêu cầu

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

{ "text": "…ít nhất 30 từ…", "lang": "vi", "options": { "web": false } }

Phản hồi

Trạng thái 200 với score (số từ trùng ÷ số từ, từ 0 đến 1), matches theo từng nguồn kèm các đoạn passages được tô sáng (vị trí ký tự trong văn bản của bạn), sourcesSearched (đúng những nguồn có câu trả lời nằm trong kết quả), sourcesSkipped kèm lý do, và webSearched.

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

Ví dụ: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"vi","text":"…ít nhất 30 từ…"}'

GET/api/v1/health

Cho biết những dịch vụ nào đang bật. Không có nội dung gửi kèm và không tính vào hạn mức.

Phản hồi

Trạng thái 200. ai là false khi công tắc tắt AI đang bật; plagiarism liệt kê các nguồn mà công cụ kiểm tra đạo văn có thể truy vấn; aidetect mô tả phần phân tích sâu phía máy chủ của công cụ nhận diện AI, hiện chưa triển khai (POST /api/v1/aidetect trả 503 disabled; công cụ nhận diện trên trang chạy ngay trong trình duyệt của bạn).

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

Ví dụ: curl

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

Task list