Detecciones de texto

POST /text/detections ejecuta una comprobación de texto. Clasifica texto sin formato con fvdoc-3-text y devuelve los pasajes escritos con IA. Es síncrono: el resultado va en la respuesta.

Los ejemplos leen el texto de un archivo, así que guarde antes cualquier pasaje de 100 palabras o más como essay.txt. El Inicio rápido incluye un comando que escribe un ejemplo.

curl https://api.fileverity.com/v1/text/detections \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 6b9d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e11" \  -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/detections", {  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" }),});const detection = await response.json();

import osimport uuidimport requests response = requests.post(    "https://api.fileverity.com/v1/text/detections",    headers={        "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"],        "Idempotency-Key": str(uuid.uuid4()),    },    json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"},)detection = response.json()

Cuerpo de la solicitud#

Los campos desconocidos se rechazan con invalid_parameter. Al comprobar el mínimo de 100 palabras, los caracteres chinos se cuentan a razón de unos dos por palabra.

Respuesta#

{  "id": "tdet_8Hk2pQ4vN9sL1xR7cW3mY6zB",  "object": "text.detection",  "created": 1793664000,  "model": "fvdoc-3-text-2026-11-03",  "livemode": true,  "language": "en",  "verdict": "mixed",  "score": 0.97,  "ai_fraction": 0.41,  "segments": [    {      "start": 212,      "end": 433,      "score": 0.97    },    {      "start": 579,      "end": 790,      "score": 0.93    }  ],  "usage": {    "characters": 1412,    "free_characters": 0,    "billed_units": 2  }}

La detección de texto devuelve una estimación estadística, no una prueba de autoría. Los límites de los segmentos son aproximados. Úsela como un elemento más de una revisión humana y no se base solo en ella para tomar decisiones que afecten a una persona.

Posiciones de los segmentos#

start y end son posiciones dentro del texto que envió, contadas en puntos de código Unicode, no en bytes ni en unidades UTF-16. Los límites de los segmentos son aproximados y pueden incluir oraciones adyacentes. Las cadenas de JavaScript se indexan por UTF-16, así que divida primero la cadena en puntos de código:

const points = Array.from(text);for (const { start, end } of detection.segments) {  console.log(points.slice(start, end).join(""));}

for segment in detection["segments"]:    print(text[segment["start"]:segment["end"]])

Las cadenas de Python ya se indexan por punto de código.

Facturación#

• El texto se factura por cada 1000 caracteres a 0,14 US$, contados en puntos de código Unicode. Cada solicitud se redondea al alza a unidades enteras, con un mínimo de una unidad.
• Primero se descuentan los caracteres de texto de su inicio gratuito, que se indican en usage.free_characters. usage.billed_units es el número de unidades que se cobran tras descontarlos, así que el importe es billed_units multiplicado por 0,14 US$. Ejemplo: 1412 caracteres, cuando ya no quedan caracteres gratuitos, se facturan como 2 unidades: 0,28 US$.
• Las solicitudes rechazadas antes de la evaluación no se cobran: parámetros no válidos, texto demasiado corto o demasiado largo, idiomas no admitidos y casos similares. Una comprobación que falla dentro del servicio (service_unavailable) se libera y no se cobra.
• Si los fondos son insuficientes, se devuelve insufficient_balance (402).

Qué se almacena#

El texto se evalúa y se descarta. Nunca se almacena, por lo que no se puede recuperar más tarde.

Fileverity conserva el resultado sin el texto (veredicto, puntuaciones, posiciones de los pasajes y uso) durante 7 días, para que la Consola pueda mostrarlo y el uso pueda facturarse y auditarse. Una solicitud repetida con la misma Idempotency-Key recibe el resultado guardado durante 24 horas. Las detecciones de texto 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#

Envíe Idempotency-Key para que, si reintenta tras un tiempo de espera agotado, no se facture dos veces. Consulte Idempotencia.