Documentación de la API de Fileverity
Comprobaciones de plagio
Encuentre pasajes de un texto sin formato que coinciden con páginas web públicas y con Wikipedia con POST /text/plagiarism. Campos de la solicitud y la respuesta, fuentes, coincidencias, exclusiones, alcance, límites y facturación.
POST /text/plagiarism comprueba un texto con plagiarism-1. Busca en páginas web públicas y en Wikipedia pasajes que coincidan con el texto y devuelve los pasajes coincidentes, las fuentes con las que coinciden y la proporción de texto coincidente. Es síncrono y suele tardar entre 20 y 60 segundos: mantenga abierta la conexión.
Funciona en inglés, español, francés y árabe. Guarde un texto de 50 palabras o más como essay.txt para ejecutar los ejemplos.
curl https://api.fileverity.com/v1/text/plagiarism \ -H "Authorization: Bearer $FILEVERITY_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: 3e8d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e31" \ --max-time 120 \ -d "$(jq -Rs '{text: ., language: "en"}' essay.txt)"import { readFile } from "node:fs/promises";import { randomUUID } from "node:crypto"; const response = await fetch("https://api.fileverity.com/v1/text/plagiarism", { method: "POST", headers: { Authorization: "Bearer " + process.env.FILEVERITY_API_KEY, "Content-Type": "application/json", "Idempotency-Key": randomUUID(), }, body: JSON.stringify({ text: await readFile("essay.txt", "utf8"), language: "en" }), signal: AbortSignal.timeout(120_000),});const check = await response.json();import osimport uuidimport requests response = requests.post( "https://api.fileverity.com/v1/text/plagiarism", headers={ "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"], "Idempotency-Key": str(uuid.uuid4()), }, json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"}, timeout=120,)check = response.json()Cuerpo de la solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
text | cadena | Sí | Texto sin formato de al menos 50 palabras y como máximo 30.000 caracteres. |
model | cadena | No | Valor predeterminado: plagiarism-1. Acepta el ID del modelo o el ID de su versión fechada plagiarism-1-2026-11-16. |
language | cadena o null | No | Código ISO 639-1: en, es, fr, ar. Se detecta automáticamente si se omite. Determina la edición de Wikipedia y el idioma de la búsqueda. |
Los campos desconocidos se rechazan con invalid_parameter. Un texto en otro idioma, o cuyo idioma no se puede reconocer, devuelve unsupported_language.
Respuesta
{ "id": "tpl_8Hk2pQ4vN9sL1xR7cW3mY6zB", "object": "text.plagiarism", "created": 1794787200, "model": "plagiarism-1-2026-11-16", "livemode": true, "language": "en", "words": 812, "scored_words": 744, "excluded_words": { "quoted": 23, "reference": 45 }, "matched_words": 61, "similarity": 0.082, "sources": [ { "id": 1, "url": "https://en.wikipedia.org/wiki/Photosynthesis", "title": "Photosynthesis", "host": "en.wikipedia.org", "words": 38, "share": 0.051, "partial": false }, { "id": 2, "url": "https://example.org/biology/light-reactions", "title": "The light reactions of photosynthesis", "host": "example.org", "words": 23, "share": 0.031, "partial": false } ], "matches": [ { "start": 1022, "end": 1288, "words": 38, "source": 1, "excerpt": "Photosynthesis is a system of biological processes by which photopigment-bearing autotrophic organisms, such as most plants, algae and cyanobacteria, convert light energy into the chemical energy necessary to fuel their metabolism.", "quoted": false, "reference": false, "exact": true }, { "start": 2410, "end": 2566, "words": 23, "source": 2, "excerpt": "In the light-dependent reactions, one molecule of the pigment chlorophyll absorbs one photon and loses one electron.", "quoted": false, "reference": false, "exact": false }, { "start": 3105, "end": 3230, "words": 19, "source": 1, "excerpt": "The term photosynthesis usually refers to oxygenic photosynthesis, a process that releases oxygen as a byproduct.", "quoted": true, "reference": false, "exact": true } ], "queries": 12, "pages": 9, "version": "2026.11-p1", "usage": { "characters": 5120, "billed_units": 6, "credits": 6 }}| Campo | Tipo | Descripción |
|---|---|---|
id | cadena | ID de la comprobación, con el prefijo tpl_. |
object | cadena | Siempre text.plagiarism. |
created | entero | Marca de tiempo Unix. |
model | cadena | Versión fechada que produjo el resultado. |
livemode | booleano | false para las claves de prueba. |
language | cadena | El idioma utilizado: el que usted envió o el detectado. |
words | entero | Palabras del texto. |
scored_words | entero | Palabras fuera de las comillas y de la lista de referencias. El denominador de similarity. |
excluded_words | objeto | quoted, palabras entre comillas, y reference, palabras de la lista de referencias, para que pueda recalcular la proporción con otras exclusiones. |
matched_words | entero | Palabras contabilizadas dentro de pasajes coincidentes, contando cada palabra una sola vez. |
similarity | número | De 0 a 1: matched_words dividido entre scored_words. Una proporción de texto coincidente, no un veredicto. |
sources | matriz | Fuentes con al menos un pasaje coincidente, de mayor a menor. Cada una tiene id, url, title, host, words, share y partial, que es true cuando solo se pudo comparar el extracto de la página que devolvió la búsqueda. |
matches | matriz | Pasajes coincidentes, en el orden del texto. Cada uno tiene start, end (excluido), words, source (el id de la fuente), excerpt (el texto coincidente en la fuente, hasta 300 caracteres), quoted, reference y exact. |
queries | entero | Frases buscadas. |
pages | entero | Páginas comparadas. |
version | cadena | Versión del método de coincidencia. Compare los resultados solo dentro de una misma versión. |
usage | objeto | characters evaluados, billed_units facturadas y credits descontados. |
El texto coincidente no es un veredicto. Las citas textuales, las expresiones habituales y los pasajes correctamente citados también coinciden, y una proporción baja no demuestra que un texto sea original. Muestre los pasajes con sus fuentes a una persona que decida en su contexto.
Cómo funciona la comprobación y qué cubre
- Las frases distintivas del texto se buscan como frases exactas en la web pública y en la edición de Wikipedia del idioma del texto. Las páginas que se obtienen se descargan y se comparan con el texto palabra por palabra, de modo que una coincidencia necesita varias palabras en el mismo orden; unas pocas palabras cambiadas o añadidas siguen coincidiendo, y entonces el pasaje se informa con
exactenfalse. - Fuentes consultadas: páginas web públicas y Wikipedia. La comprobación no ve libros, revistas de pago, trabajos de otros estudiantes, plataformas de aprendizaje ni bases de datos privadas. Las páginas que rechazan el acceso automatizado se comparan solo a través de su extracto de búsqueda (
partial). - No se encuentra: texto parafraseado, texto traducido ni texto cuya fuente no es pública. Un texto puede estar copiado y no devolver ninguna coincidencia.
- Exclusiones: los pasajes entre comillas tienen
quotedentrue, y los pasajes que siguen a un encabezado como References, Bibliography, Références, Referencias o المراجع tienenreferenceentrue. Ambos quedan fuera desimilarity; useexcluded_wordspara incluirlos. - Se envían frases del texto a Brave Search y a Wikipedia para encontrar páginas candidatas. Nunca se les envía el texto completo y no se añade nada a ninguna base de datos.
Posiciones
start y end de cada coincidencia son posiciones en el texto que envió, medidas en puntos de código Unicode, no en bytes ni en unidades UTF-16. Las cadenas de JavaScript se indexan en UTF-16, así que divídalas primero en puntos de código:
const points = Array.from(text);for (const { start, end, source } of check.matches) { console.log(source, points.slice(start, end).join(""));}for match in check["matches"]: print(match["source"], text[match["start"]:match["end"]])Facturación
- Una comprobación de plagio cuesta 1 crédito por cada 1000 caracteres, contados en puntos de código Unicode. Cada solicitud se redondea hacia arriba a unidades completas, con un mínimo de una unidad.
usage.billed_unitses el número de unidades facturadas yusage.creditslos créditos descontados. Ejemplo: 5120 caracteres facturan 6 unidades, es decir, 6 créditos.- Una comprobación que no encuentra ninguna fuente coincidente se cobra igualmente: la búsqueda se ha realizado. Las solicitudes rechazadas antes de la evaluación no se cobran, y una comprobación que falla dentro del servicio (
service_unavailable) se libera y no se cobra. - Si no hay créditos suficientes, se devuelve
insufficient_balance(402). A través de la API, las comprobaciones de plagio están abiertas a los espacios de trabajo que han comprado créditos y siempre consumen créditos; en el sitio web y en la Consola forman parte del plan Pro.
Qué se almacena
Se conserva una copia cifrada del texto durante un máximo de 3 años para entrenar y evaluar los modelos de detección de Fileverity; consulte Conservación de datos y seguridad. Fileverity conserva durante 7 días el resultado (las fuentes, las posiciones de las coincidencias con breves extractos de la fuente, los recuentos y el uso), para que la Consola pueda mostrarlo y el uso pueda facturarse y auditarse. Las páginas descargadas se comparan en memoria y no se conservan. Una solicitud repetida con la misma Idempotency-Key recibe el resultado guardado durante 24 horas. Las comprobaciones de plagio son síncronas: no aparecen en GET /analyses y no envían eventos de webhook. Las claves de prueba no registran nada. Consulte Conservación de datos y seguridad.
Errores
| Código | Estado | Causa |
|---|---|---|
text_too_short | 400 | Menos de 50 palabras. |
text_too_long | 413 | Más de 30.000 caracteres. Divida el texto en varias solicitudes. |
unsupported_language | 400 | El texto no está en inglés, español, francés ni árabe, o no se pudo reconocer su idioma. Envíe language para elegir uno. |
unsupported_media_type | 415 | El cuerpo no se envía como application/json. |
invalid_json, missing_parameter, invalid_parameter | 400 | El cuerpo no es un objeto JSON, falta text, un campo tiene un tipo incorrecto o se envió un campo desconocido. |
model_not_found | 404 | El model es desconocido. |
plan_required | 403 | El espacio de trabajo aún no ha comprado créditos. Compre un paquete de créditos en la Consola. |
insufficient_balance | 402 | El saldo no cubre la solicitud. |
spend_limit_reached | 402 | La clave alcanzó su límite de gasto mensual. |
idempotency_mismatch, idempotency_in_progress | 409 | La Idempotency-Key se usó con un cuerpo distinto, o su primera solicitud sigue en curso. |
service_unavailable, analysis_failed | 503, 502 | No se pudo completar la búsqueda o la comparación. No se cobra; reintente. service_unavailable incluye una cabecera retry-after. |
Envíe Idempotency-Key para que, si reintenta tras un tiempo de espera agotado, no se facture dos veces. Consulte Idempotencia.