# 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.

Fuente: https://fileverity.com/es/docs/plagiarism

`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.

**Solicitud: cURL**

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

**Solicitud: JavaScript**

```javascript
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();
```

**Solicitud: Python**

```python
import os
import uuid
import 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

**200 OK**

```json
{
  "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. |

> **Nota.** 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:

**Extraer una coincidencia: JavaScript**

```javascript
const points = Array.from(text);
for (const { start, end, source } of check.matches) {
  console.log(source, points.slice(start, end).join(""));
}
```

**Extraer una coincidencia: Python**

```python
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_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](https://fileverity.com/es/docs/security.md#retention). 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](https://fileverity.com/es/docs/security.md).

## 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`. |

> **Nota.** Envíe `Idempotency-Key` para que, si reintenta tras un tiempo de espera agotado, no se facture dos veces. Consulte [Idempotencia](https://fileverity.com/es/docs/idempotency.md).

