Kufafanua upya, kukagua sarufi, muhtasari, tafsiri na ukaguzi wa wizi wa maandishi katika lugha 56 kwa programu yako. REST rahisi inayohudumiwa kutoka ukingo wa mtandao wa Cloudflare.
API ya AdeptWrite v1 ina endpoint tatu zinazofanya kazi. POST /api/v1/run hupokea JSON yenye task, mode, lang na text (hadi herufi 6,000) na kurudisha maandishi matupu kutoka kwa modeli ya Cloudflare Workers AI iliyochaguliwa kulingana na lugha; POST /api/v1/plagiarism hulinganisha maandishi na vyanzo huria na kuorodhesha kila chanzo kilichotafutwa; GET /api/v1/health hurudisha hali ya huduma. Maandishi hayahifadhiwi wala kurekodiwa kamwe, na maombi ya AI yamewekewa kikomo cha 30 kwa dakika kwa kila IP.
https://adeptwrite.com/api/v1Content-Type: application/json, UTF-8).text haihifadhiwi wala kurekodiwa; majibu hubeba Cache-Control: no-store./v1/ haitabadilika kwa namna isiyooana; mabadiliko makubwa yatatumia /v2/./api/v1/runHuendesha kazi moja ya AI kwenye maandishi na kurudisha matokeo kama maandishi matupu (bila utangulizi, bila vizuizi vya Markdown).
| Field | Type | Required | Notes |
|---|---|---|---|
task | string | ✓ | Jina la kazi; tazama orodha ya task hapa chini. |
text | string | ✓ | Maandishi ya kuingiza, herufi 1–6,000. |
lang | string | ✓ | Lugha ya matokeo: mojawapo ya misimbo 56 ya lokali za tovuti (sw, en, id, ja, pt-pt, zh-hant na kadhalika; tagi za BCP 47 kama pt-BR pia hulinganishwa) au auto kumaanisha "sawa na lugha ya maandishi ya kuingiza". |
mode | string | — | Hali inayopatikana kwa zana hiyo, kwa mfano Formal, Akademik, Ringkas, Poin-poin. Hupuuzwa kama kazi haina hali. |
options | object | — | Chaguo za ziada kwa kila kazi: from / to kwa translate (kutoka lugha yoyote inayotumika kwenda nyingine; from inaweza kuwa auto; sr-Cyrl huomba Kiserbia kwa herufi za Kisirili), platform (instagram / tiktok / linkedin) kwa caption, na fields zenye lebo za hiari kwa bio, coverletter na meta. Funguo nyingine hupuuzwa. |
POST /api/v1/run HTTP/1.1
Content-Type: application/json
{
"task": "paraphrase",
"mode": "Formal",
"lang": "sw",
"text": "Ubora wa uandishi ni muhimu sana kwa wanafunzi wa chuo.",
"options": {}
}Hali 200 yenye ok: true, matokeo kwenye output, modeli iliyojibu kweli kwenye model (tofauti ikiwa modeli mbadala imechukua nafasi) na muda wa uchakataji kwa milisekunde. truncated: true huongezwa jibu likikatwa kwa kufikia kikomo cha urefu au cha muda.
{
"ok": true,
"output": "Ubora wa maandishi una umuhimu mkubwa kwa wanafunzi wa chuo.",
"model": "@cf/qwen/qwen3-30b-a3b-fp8",
"ms": 812
}curl -X POST https://adeptwrite.com/api/v1/run \
-H "Content-Type: application/json" \
-d '{"task":"grammar","lang":"sw","text":"Wanafunzi wote wamefika shuleni mapema leo asubuhi."}'const res = await fetch('/api/v1/run', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ task: 'summarize', mode: 'Poin-poin', lang: 'sw', text }),
});
const data = await res.json();
if (!data.ok) throw new Error(data.error.code + ': ' + data.error.message);
console.log(data.output);/api/v1/plagiarismHuchagua vifungu 4–8 vya kipekee kutoka kwenye maandishi, huvitafuta kwenye vyanzo huria kulingana na lugha ya maandishi (Wikipedia, Wikisource, maandishi kamili ya Internet Archive, Europe PMC, DOAJ, arXiv; mtoa huduma wa utafutaji wa wavuti hutumika tu akiwa amesanidiwa na ameombwa), kisha hukokotoa mwingiliano. Ni vifungu hivyo vifupi tu vinavyotoka kwenye seva.
| Field | Type | Required | Notes |
|---|---|---|---|
text | string | ✓ | Maneno 30 angalau, herufi 6,000 kwa upeo. |
lang | string | ✓ | Msimbo wa lokali ya tovuti au auto. |
options | object | — | web: true hutumia pia mtoa huduma wa utafutaji wa wavuti kama mwendeshaji ameusanidi; webSearched kwenye jibu hueleza kama mtoa huduma huyo alijibu kweli. |
POST /api/v1/plagiarism HTTP/1.1
Content-Type: application/json
{ "text": "…maneno 30 angalau…", "lang": "sw", "options": { "web": false } }Hali 200 yenye score (maneno yaliyolingana ÷ jumla ya maneno, 0–1), matches kwa kila chanzo pamoja na passages zilizoangaziwa (nafasi za herufi kwenye maandishi yako), sourcesSearched (hasa vyanzo ambavyo majibu yake yamo kwenye matokeo), sourcesSkipped pamoja na sababu zake, na webSearched.
{
"ok": true,
"score": 0.42,
"words": 52,
"matchedWords": 22,
"matches": [{ "source": "wikipedia", "title": "…", "url": "https://sw.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 -X POST https://adeptwrite.com/api/v1/plagiarism \
-H "Content-Type: application/json" \
-d '{"lang":"sw","text":"…maneno 30 angalau…"}'/api/v1/healthHuripoti huduma zipi zimewashwa. Haihitaji mwili wa ombi na haihesabiwi kwenye kiwango cha matumizi.
Hali 200. ai ni false wakati swichi ya kuzima AI imewashwa; plagiarism huorodhesha vyanzo ambavyo kikagua kinaweza kuvitafuta; aidetect inaeleza uchambuzi wa kina wa kigunduzi cha AI upande wa seva, ambao bado haujasakinishwa (POST /api/v1/aidetect hujibu 503 disabled; kigunduzi kilicho kwenye tovuti hufanya kazi ndani ya kivinjari chako).
{
"ok": true,
"ai": true,
"plagiarism": { "enabled": true, "sources": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj", "arxiv"], "web": false },
"aidetect": { "enabled": false, "judge": false }
}curl https://adeptwrite.com/api/v1/healthtask | What it does |
|---|---|
paraphrase | Kufafanua upya; hali: Standar, Formal, Santai, Akademik, Kreatif, Ringkas, Panjangkan. |
grammar | Kusahihisha sarufi na tahajia. |
tone | Kubadilisha toni; hali: Formal (rasmi), Kantor (ofisini), Santai (ya kirafiki). |
rewrite | Kurekebisha sentensi ngumu au zenye utata; hali: Standar, Formal. |
resize | Kufupisha au kurefusha sentensi; hali: Ringkas, Panjangkan. |
essay | Kujenga aya au insha kutoka kwenye hoja fupi; hali: Akademik, Kreatif, Panjangkan. |
summarize | Muhtasari; hali: Poin-poin (vitone), Paragraf (aya), Satu kalimat (sentensi moja). |
translate | Tafsiri kati ya lugha mbili zozote zinazotumika; options.from (au auto) na options.to; hali: Alami (asilia, chaguo-msingi), Formal (rasmi), Santai (ya kirafiki). |
thesis | Mawazo ya mada za tasnifu na mpangilio wa sura. |
abstract | Muhtasari wa utafiti wenye muundo kutoka kwenye maelezo ya utafiti. |
caption | Maelezo ya picha ya mitandao ya kijamii; options.platform: instagram, tiktok, linkedin. |
email | Barua pepe na barua; hali: Lamaran kerja (maombi ya kazi), Surat resmi (barua rasmi), Follow-up (ufuatiliaji). |
headline | Vichwa vya makala na vya habari; hali: Kreatif, Ringkas. |
product | Maelezo ya bidhaa; hali: Marketplace (soko la mtandaoni), Toko online (duka la mtandaoni). |
synonym | Orodha ya visawe vya neno au msemo mmoja. |
humanize | Kufanya maandishi magumu na ya kawaida kupita kiasi yasomeke kwa asili zaidi; hali: Alami, Pribadi (kibinafsi), Profesional (kitaaluma). |
meta | Jozi tatu za kichwa na maelezo ya meta; hali: Artikel (makala), Produk (bidhaa), Halaman (ukurasa wowote wa wavuti). |
hashtag | Mstari mmoja wa hashtag; hali: Instagram, TikTok, LinkedIn, X. |
bio | Wasifu mfupi watatu wa wasifu-binafsi; hali: Instagram, LinkedIn, X, TikTok. |
outline | Mpangilio wenye namba na vipengele vidogo; hali: Artikel (makala), Esai (insha), Skripsi (tasnifu), Presentasi (wasilisho). |
slogan | Mawazo kumi ya kauli mbiu; hali: Merek (chapa), Kampanye (kampeni), Produk (bidhaa). |
paragraph | Aya moja kutoka kwenye mada; hali: Pembuka (utangulizi), Isi (mwili), Penutup (hitimisho). |
coverletter | Rasimu ya barua ya maombi ya kazi; hali: Fresh graduate (mhitimu mpya), Berpengalaman (mwenye uzoefu), Magang (mafunzo kwa vitendo). |
poem | Mashairi mafupi; hali: Bebas (huru), Berima (ya vina), Akrostik (akrostiki), Haiku. |
413 too_long ukizidi).truncated: true.@cf/aisingapore/gemma-sea-lion-v4-27b-it, lugha nyingine zote hutumia @cf/qwen/qwen3-30b-a3b-fp8. Modeli ikiwa na shughuli nyingi, imefikia kikomo, ni polepole au imeshindwa, ombi huhamia modeli inayofuata kwenye mnyororo mbadala (Qwen3-30B, kisha @cf/google/gemma-4-26b-a4b-it, kisha @cf/meta/llama-3.3-70b-instruct-fp8-fast). Sehemu ya model hutaja kila mara modeli iliyojibu.| Hali | Msimbo | Hutokea lini |
|---|---|---|
400 | invalid_request | JSON isiyo sahihi, sehemu ya lazima haipo, au task au lang isiyojulikana. |
413 | too_long | text inazidi herufi 6,000. |
403 | forbidden | Ombi halikutoka kwenye ukurasa wa adeptwrite.com. |
429 | rate_limited | Kikomo cha kila dakika kwa IP au cha jumla kimezidiwa. Subiri idadi ya sekunde zilizo kwenye Retry-After. |
429 | quota_exceeded | Kikomo cha kila siku cha vipengele vya AI kimekwisha. Jaribu tena siku inayofuata (UTC). |
502 | upstream | Modeli zote kwenye mnyororo zimeshindwa kujibu kwa wakati. |
502 | empty_output | Modeli zilijibu, lakini matokeo yalikuwa matupu. |
503 | disabled | Huduma imezimwa kwa muda na mwendeshaji, au (kwa /api/v1/aidetect) bado haijasakinishwa. |
Kila hitilafu hurudishwa kama JSON yenye msimbo wa hali wa HTTP unaolingana na umbo lilelile:
{ "ok": false, "error": { "code": "rate_limited", "message": "Maombi ni mengi mno. Tafadhali jaribu tena baada ya muda mfupi." } }
Angalia ok kwanza, kisha soma error.code kwa ushughulikiaji wa kiprogramu; error.message ni salama kuonyeshwa kwa watumiaji.
429 kwa kusubiri kwa muda unaoongezeka, si kwa kujaribu tena mara moja.Bado. Kwa sasa Worker haitumi vichwa vya CORS na inahudumia kurasa za adeptwrite.com pekee. Ufikiaji wa nje kwa funguo za API unapangwa pamoja na mpango wa Pro; nyaraka hizi zitasasishwa mara tu utakapopatikana kweli.
Hapana. Maandishi hupelekwa kwa modeli ili kutoa jibu kisha hutupwa. Kumbukumbu za seva hubeba taarifa za kiufundi tu kama msimbo wa hali, jina la task na muda, bila maudhui ya maandishi hata kidogo. Tazama sera ya faragha kwa maelezo kamili.
Kila task hutoa maandishi moja yaliyo tayari kutumika bila utangulizi wala vizuizi vya Markdown ili yaonyeshwe moja kwa moja kwenye kihariri. Muundo wa ziada (kwa mfano orodha ya mabadiliko) unapangwa kwa toleo la baadaye bila kubadilisha v1.
Kutoka kwenye tovuti ya adeptwrite.com ni bure, kwa kikomo cha maombi 30 ya AI kwa dakika kwa kila IP. Bei ya ufikiaji wa nje itatangazwa pamoja na mpango wa Pro; hakuna malipo yoyote kabla ya hapo.
Inategemea lugha: Kiingereza na Kiindonesia hushughulikiwa na SEA-LION, lugha nyingine, ikiwemo Kiswahili, hushughulikiwa na Qwen3-30B. Modeli hiyo ikiwa na shughuli nyingi au ikishindwa, modeli inayofuata kwenye mnyororo mbadala hujibu, na sehemu ya model kwenye jibu hutaja modeli iliyojibu kweli.