Documentação da API

POST/api/v1/run

Executa uma tarefa de IA sobre um texto e devolve o resultado em texto simples (sem preâmbulo e sem blocos de código Markdown).

Pedido

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "pt-pt",
  "text": "Escrever bem é muito importante para os estudantes.",
  "options": {}
}

Resposta

Estado 200 com ok: true, o resultado em output, o modelo que realmente respondeu em model (difere quando um modelo de recurso entrou em ação) e o tempo de processamento em milissegundos. Acrescenta-se truncated: true quando a resposta atingiu o limite de tamanho ou de tempo e foi cortada.

{
  "ok": true,
  "output": "A qualidade da escrita é essencial para os estudantes.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Exemplo: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"pt-pt","text":"Eles foram ao mercado e comprarão fruta."}'

Exemplo: 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: 'pt-pt', 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

Escolhe 4 a 8 expressões distintivas do texto, pesquisa fontes abertas na língua do texto (Wikipédia, Wikisource, texto integral do Internet Archive, Europe PMC, DOAJ, arXiv; um fornecedor de pesquisa na web só quando configurado e pedido) e calcula a sobreposição. Só essas expressões curtas saem do servidor.

Pedido

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

{ "text": "…pelo menos 30 palavras…", "lang": "pt-pt", "options": { "web": false } }

Resposta

Estado 200 com score (palavras coincidentes ÷ palavras, de 0 a 1), matches por fonte com passages destacadas (deslocamentos de caracteres no seu texto), sourcesSearched (exatamente as fontes cujas respostas constam do resultado), sourcesSkipped com o motivo, e webSearched.

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

Exemplo: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"pt-pt","text":"…pelo menos 30 palavras…"}'

GET/api/v1/health

Indica que serviços estão ligados. Não leva corpo e não conta para a quota.

Resposta

Estado 200. ai é falso enquanto o interruptor de emergência da IA estiver ligado; plagiarism lista as fontes que o verificador pode consultar; aidetect descreve a análise profunda do detetor de IA no servidor, que ainda não está em produção (POST /api/v1/aidetect responde 503 disabled; o detetor do sítio corre no seu navegador).

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

Exemplo: curl

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

Task list