Documentación de la API

POST/api/v1/run

Ejecuta una tarea de IA sobre un texto y devuelve el resultado como texto plano (sin preámbulo y sin bloques de código Markdown).

Solicitud

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "es",
  "text": "Escribir bien es muy importante para los estudiantes.",
  "options": {}
}

Respuesta

Estado 200 con ok: true, el resultado en output, el modelo que respondió realmente en model (es distinto cuando ha intervenido un modelo de respaldo) y el tiempo de procesamiento en milisegundos. Se añade truncated: true cuando la respuesta alcanzó su límite de longitud o de tiempo y se cortó.

{
  "ok": true,
  "output": "Redactar con corrección resulta fundamental para el alumnado.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Ejemplo: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"es","text":"Ayer fuimos a la biblioteca y haber si encontramos el libro."}'

Ejemplo: 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: 'es', 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

Elige de 4 a 8 frases distintivas del texto, las busca en fuentes abiertas en el idioma del texto (Wikipedia, Wikisource, texto completo de Internet Archive, Europe PMC, DOAJ y arXiv; un proveedor de búsqueda web solo si está configurado y se solicita) y puntúa la coincidencia. Solo esas frases cortas salen del servidor.

Solicitud

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

{ "text": "…al menos 30 palabras…", "lang": "es", "options": { "web": false } }

Respuesta

Estado 200 con score (palabras coincidentes ÷ palabras, de 0 a 1), matches por fuente con passages resaltados (desplazamientos de caracteres dentro de tu texto), sourcesSearched (exactamente las fuentes cuyas respuestas están en el resultado), sourcesSkipped con el motivo y webSearched.

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

Ejemplo: curl

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

GET/api/v1/health

Indica qué servicios están activados. No lleva cuerpo y no cuenta para la cuota.

Respuesta

Estado 200. ai es false mientras el interruptor de emergencia de la IA está activado; plagiarism enumera las fuentes que puede consultar el comprobador; aidetect describe el análisis profundo del detector de IA en el servidor, que todavía no está desplegado (POST /api/v1/aidetect responde 503 disabled; el detector del sitio se ejecuta en tu navegador).

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

Ejemplo: curl

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

Task list