Ir al contenido

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.

Ver como MarkdownActualizado el 2026-11-16

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)"

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
textcadenaSíTexto sin formato de al menos 50 palabras y como máximo 30.000 caracteres.
modelcadenaNoValor predeterminado: plagiarism-1. Acepta el ID del modelo o el ID de su versión fechada plagiarism-1-2026-11-16.
languagecadena o nullNoCó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  }}
CampoTipoDescripción
idcadenaID de la comprobación, con el prefijo tpl_.
objectcadenaSiempre text.plagiarism.
createdenteroMarca de tiempo Unix.
modelcadenaVersión fechada que produjo el resultado.
livemodebooleanofalse para las claves de prueba.
languagecadenaEl idioma utilizado: el que usted envió o el detectado.
wordsenteroPalabras del texto.
scored_wordsenteroPalabras fuera de las comillas y de la lista de referencias. El denominador de similarity.
excluded_wordsobjetoquoted, palabras entre comillas, y reference, palabras de la lista de referencias, para que pueda recalcular la proporción con otras exclusiones.
matched_wordsenteroPalabras contabilizadas dentro de pasajes coincidentes, contando cada palabra una sola vez.
similaritynúmeroDe 0 a 1: matched_words dividido entre scored_words. Una proporción de texto coincidente, no un veredicto.
sourcesmatrizFuentes 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.
matchesmatrizPasajes 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.
queriesenteroFrases buscadas.
pagesenteroPáginas comparadas.
versioncadenaVersión del método de coincidencia. Compare los resultados solo dentro de una misma versión.
usageobjetocharacters 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 exact en false.
  • 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 quoted en true, y los pasajes que siguen a un encabezado como References, Bibliography, Références, Referencias o المراجع tienen reference en true. Ambos quedan fuera de similarity; use excluded_words para 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(""));}

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_units es el número de unidades facturadas y usage.credits los 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ódigoEstadoCausa
text_too_short400Menos de 50 palabras.
text_too_long413Más de 30.000 caracteres. Divida el texto en varias solicitudes.
unsupported_language400El 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_type415El cuerpo no se envía como application/json.
invalid_json, missing_parameter, invalid_parameter400El cuerpo no es un objeto JSON, falta text, un campo tiene un tipo incorrecto o se envió un campo desconocido.
model_not_found404El model es desconocido.
plan_required403El espacio de trabajo aún no ha comprado créditos. Compre un paquete de créditos en la Consola.
insufficient_balance402El saldo no cubre la solicitud.
spend_limit_reached402La clave alcanzó su límite de gasto mensual.
idempotency_mismatch, idempotency_in_progress409La Idempotency-Key se usó con un cuerpo distinto, o su primera solicitud sigue en curso.
service_unavailable, analysis_failed503, 502No 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.