API de detección de fraude documental
API de detección de fraude documental para archivos PDF y Word.
Detecte ediciones, falsificaciones y texto escrito con IA en PDF y Word con dos llamadas a la API. Informe verificable, 5,99 US$ por documento.
Inicio gratuito: 5 comprobaciones de imagen o documento y 5.000 caracteres de texto. Sin tarjeta, sin suscripción.
- Endpoints
- POST /v1/files, POST /v1/analyses
- Modelo
- fvdoc-3 · FVDOC V3
- Archivos admitidos
- PDF, DOCX, DOC, RTF, ODT, PPTX, TXT
- Tamaño máximo
- Hasta 50 MB y 100 páginas
- Resultado
- En la misma solicitud o mediante webhook
- Precio
- 5,99 US$ por comprobación de documento
Última actualización
Qué comprueba
Qué examina la comprobación de documentos.
Cada señal forma parte del mismo informe que obtiene en la Consola. La columna «Campo de la respuesta» indica dónde leerla.
| Señal | Qué se examina | Campo de la respuesta |
|---|---|---|
| Historial de ediciones y estructura del archivo | Revisiones guardadas, páginas modificadas o añadidas y cómo se construyó el archivo. | structure |
| Firmas y registros del archivo | Firmas digitales, registros de creación y modificación, y el software que figura en el archivo. | provenance |
| Fotos incrustadas | Fotos dentro del documento, cada una examinada en busca de generación con IA y ediciones locales. | images |
| Texto escrito con IA | Un veredicto sobre el texto del documento, con los pasajes escritos con IA marcados por página. | text |
| Hallazgos y siguiente paso | Los hallazgos que sustentan el nivel de riesgo, su solidez y una acción recomendada. | findings, level, action |
Solicitud y respuesta
Dos llamadas y un informe.
Suba el archivo y cree después la comprobación con el modelo fvdoc-3. Envíe Prefer: wait para mantener la solicitud abierta hasta que el informe esté listo. Los documentos pueden quedar en cola, así que una comprobación puede responder 202 con el estado processing. Consúltela más tarde o reciba un webhook.
FILE_ID=$(curl -s https://api.fileverity.com/v1/files \ -H "Authorization: Bearer $FILEVERITY_API_KEY" \ -F file=@contract.pdf | jq -r .id) curl https://api.fileverity.com/v1/analyses \ -H "Authorization: Bearer $FILEVERITY_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Prefer: wait=60" \ -d "{\"model\": \"fvdoc-3\", \"file\": \"$FILE_ID\"}"import { readFile } from "node:fs/promises"; const headers = { Authorization: "Bearer " + process.env.FILEVERITY_API_KEY }; const form = new FormData();form.append("file", new Blob([await readFile("contract.pdf")], { type: "application/pdf" }), "contract.pdf");const file = await (await fetch("https://api.fileverity.com/v1/files", { method: "POST", headers, body: form })).json(); const response = await fetch("https://api.fileverity.com/v1/analyses", { method: "POST", headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), Prefer: "wait=60" }, body: JSON.stringify({ model: "fvdoc-3", file: file.id }),});const analysis = await response.json();console.log(analysis.status, analysis.summary, analysis.report_url);import osimport uuidimport requests headers = {"Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"]} file = requests.post("https://api.fileverity.com/v1/files", headers=headers, files={"file": open("contract.pdf", "rb")}).json() response = requests.post( "https://api.fileverity.com/v1/analyses", headers={**headers, "Idempotency-Key": str(uuid.uuid4()), "Prefer": "wait=60"}, json={"model": "fvdoc-3", "file": file["id"]},)analysis = response.json()print(analysis["status"], analysis["summary"], analysis["report_url"]){ "id": "an_Zc4vB7nP1sK8tL3wR6yQm2Xa", "object": "analysis", "created": 1793700300, "model": "fvdoc-3-2026-11-03", "livemode": true, "status": "succeeded", "file": { "name": "contract.pdf", "bytes": 18874368, "format": "pdf" }, "report_id": "FV-3PXH-6WQ2-8NDC", "report_url": "https://fileverity.com/verify/FV-3PXH-6WQ2-8NDC", "summary": { "kind": "docpro", "level": "L3", "action": "review", "reason": null, "findings": [], "pages": 12, "images": 3, "text": "human" }, "result": { "report": { "schema": "fileverity.docpro/1", "id": "FV-3PXH-6WQ2-8NDC" }, "stamped_at": 1793700340 }, "error": null, "progress": null, "usage": { "amount": 599, "currency": "usd", "funding": "balance" }, "metadata": null, "completed_at": 1793700341, "expires_at": 1794305141}Dónde encaja
Póngala donde un archivo se convierte en una decisión.
La API devuelve un nivel de riesgo y una acción recomendada. La decisión final sigue en manos de su equipo.
Crédito y justificantes de ingresos
- Usted envía
- Nóminas, extractos bancarios y cartas del empleador de una solicitud.
- Usted recibe
- Un nivel de riesgo, una acción recomendada y los hallazgos que los sustentan, con las páginas implicadas.
- Después, su equipo
- Derive a un analista, con el informe adjunto, los archivos que requieran un examen más detenido.
Siniestros y seguros
- Usted envía
- Facturas, presupuestos de reparación, recibos y declaraciones presentados con un siniestro.
- Usted recibe
- Hallazgos sobre ediciones, fotos incrustadas y pasajes escritos con IA, más un ID de informe para el expediente.
- Después, su equipo
- Adjunte el ID de informe al siniestro y pida el documento original cuando los hallazgos lo aconsejen.
Cuentas por pagar y facturas
- Usted envía
- Facturas de proveedores y cartas que cambian datos bancarios, antes de una remesa de pagos.
- Usted recibe
- El historial de ediciones, los registros del archivo y un hallazgo cuando algo cambió después de crear el archivo.
- Después, su equipo
- Confirme con el proveedor los importes o el beneficiario modificados antes de pagar.
Alta de proveedores, inquilinos y empleados
- Usted envía
- Certificados, diplomas, cartas de referencia y justificantes de domicilio.
- Usted recibe
- Un informe sobre el propio archivo: ediciones, firmas, fotos incrustadas y texto escrito con IA.
- Después, su equipo
- Verifique la credencial con su emisor cuando el informe aconseje una revisión.
Límites
Lo que no hace.
Un resultado limpio acota una revisión, pero no la sustituye.
- No lee documentos de identidad, no compara rostros ni hace pruebas de vida. Úsela como complemento de un proveedor de verificación de identidad.
- Un resultado sin hallazgos no prueba que un documento sea auténtico ni que lo que dice sea cierto.
- Comprueba el archivo, no los hechos. No puede confirmar que un importe, un beneficiario o un emisor sean correctos, así que siga verificándolos en la fuente.
- Hay contenido que no se puede examinar, como las páginas escaneadas sin texto o los pasajes muy cortos. El informe indica qué no se examinó.
- Las fotos y capturas de pantalla de documentos son imágenes, no documentos. Compruébelas con la API de imágenes.
Evidencias
Evidencias que usted conserva.
Cada comprobación deja un registro que puede guardar, compartir y volver a comprobar más adelante, no solo un veredicto.
ID de informe
Un ID de informe con el formato FV-XXXX-XXXX-XXXX. Guárdelo junto a su propio expediente o ficha de cliente.
Huellas y marca de tiempo
Con cada informe se registran huellas SHA-256 del archivo y del informe, y una marca de tiempo RFC 3161.
Página de verificación pública
Quien reciba el ID del informe puede confirmarlo en la página de verificación, sin cuenta.
Archivos eliminados, resultados conservados
Los archivos subidos se eliminan tras la comprobación y nunca se usan para entrenar modelos. El resultado sigue disponible a través de la API durante 7 días.
Integración
Intégrela en su flujo de trabajo.
Las comprobaciones de imágenes y de documentos siguen el mismo patrón, así que una sola integración cubre ambas.
- Espere el resultado con Prefer: wait, o reciba un webhook firmado cuando termine la comprobación. Gestione tanto una respuesta terminada como una respuesta en proceso.
- Envíe un Idempotency-Key en cada solicitud POST, para que un reintento nunca ejecute una comprobación dos veces.
- Desarrolle primero con claves fv_test_. Devuelven resultados de ejemplo fijos y nunca se cobran.
- Las comprobaciones fallidas no se cobran. Un servicio ocupado responde 503 con una cabecera retry-after, y usted reintenta con la misma clave.
- Los webhooks van firmados y siguen la especificación Standard Webhooks.
- Los archivos de hasta 4 MB se envían en una sola solicitud multipart. Los más grandes usan una URL de subida prefirmada, hasta el límite del modelo.
- Las solicitudes están limitadas a 120 por minuto y clave.
Precios
Pague por cada comprobación.
Un único saldo prepago del espacio de trabajo cubre las comprobaciones de imágenes, documentos y texto. Recargue desde 19 US$. No hay suscripción ni renovaciones.
| Comprobación | Se factura por | Precio |
|---|---|---|
| Comprobación de imagenSe factura por imagen | imagen | 1,99 US$ |
| Comprobación de documentoSe factura por documento | documento | 5,99 US$ |
| Comprobación de textoSe factura por 1000 caracteres | 1000 caracteres | 0,14 US$ |
En cada solicitud, el texto se redondea al siguiente múltiplo de 1000 caracteres. Una comprobación de texto requiere al menos 100 palabras.
Inicio gratuito
Pruébelo antes de añadir fondos.
Su primer espacio de trabajo empieza con 5 comprobaciones gratuitas de imágenes o documentos y 5.000 caracteres de texto gratuitos.
No hace falta tarjeta para empezar. Hay un inicio gratuito por persona y un número limitado por dominio de correo de empresa. Sus compañeros deben unirse mediante invitación.
Preguntas frecuentes
¿Cómo detecto un PDF falsificado mediante la API?
Suba el PDF con POST /v1/files y cree después una comprobación con POST /v1/analyses y el modelo fvdoc-3. La respuesta incluye hallazgos del historial de ediciones, las firmas, las fotos incrustadas y el texto, un nivel de riesgo y una acción recomendada, además de un ID de informe que cualquiera puede verificar.
¿Puede detectar documentos generados con IA?
Detecta texto escrito con IA: la comprobación marca los pasajes escritos con IA por página e indica cuándo el texto no pudo evaluarse, por ejemplo en páginas escaneadas sin texto. También examina las fotos incrustadas en busca de generación con IA. Tome el resultado como evidencia para una revisión, no como prueba.
¿Verifica documentos de identidad o pasaportes?
No. No lee documentos de identidad, no compara rostros ni hace pruebas de vida. Examina el archivo del documento, no a la persona que lo presenta, así que úsela como complemento de un proveedor de verificación de identidad.
¿Cuánto cuesta una comprobación de documento?
5,99 US$ por comprobación de documento, que se descuentan de un saldo prepago del espacio de trabajo que usted recarga desde 19 US$. No hay suscripción. Las comprobaciones fallidas no se cobran, y las claves de prueba nunca.
¿Hay inicio gratuito y modo de prueba?
Su primer espacio de trabajo empieza con 5 comprobaciones gratuitas de imágenes o documentos y 5.000 caracteres de texto gratuitos, sin tarjeta. Hay un inicio gratuito por persona y un número limitado por dominio de correo de empresa. Las claves que empiezan por fv_test_ devuelven resultados de ejemplo fijos y nunca se cobran.
¿Qué formatos y tamaños de archivo se admiten?
Formatos admitidos: PDF, DOCX, DOC, RTF, ODT, PPTX, TXT. Los límites son 50 MB y 100 páginas por archivo. Los archivos de hasta 4 MB se envían en una sola solicitud multipart; los más grandes usan una URL de subida prefirmada. Una foto JPEG, PNG o WebP de un documento es, en cambio, una comprobación de imagen.
¿Cuánto tiempo se conservan los archivos y los resultados?
Los archivos subidos se eliminan tras la comprobación. El resultado se conserva 7 días para que pueda consultarlo de nuevo, y la página de verificación pública confirma el ID del informe, la huella del archivo y la marca de tiempo.
Guías
Guías prácticas para equipos de revisión.
Qué establece cada comprobación, dónde se detiene y qué prueba conviene pedir a continuación.
Documentos
Fraude documental con IA: qué comprobación necesita cada caso
Texto escrito con IA, páginas generadas, campos alterados o documentos auténticos fuera de contexto: qué comprobación corresponde a cada caso.
16 min de lectura ·
Documentos
Cómo saber si un PDF ha sido modificado
Cómo saber si un PDF ha sido modificado: validar la firma electrónica (VALIDe, lector de PDF), cotejar el CSV y comparar con la copia del emisor.
21 min de lectura ·
Documentos
Cómo verificar una factura antes de pagarla: importes, rectificativas y cambios de cuenta
Compruebe importes, albaranes, facturas rectificativas, pagos previos y cambios de IBAN antes de aprobar un pago, con un caso práctico en euros.
20 min de lectura ·
Evaluar la verificación
Cómo elegir una API de detección de IA: diez puntos que comprobar antes de integrarla
Guía para elegir una API de detección de IA: límites, resultados síncronos o asíncronos, webhooks, evidencias, conservación, modo de prueba y precios.
19 min de lectura ·
Haga su primera comprobación en minutos.
Abra la Consola, use su inicio gratuito y envíe una solicitud de prueba. Añada fondos solo cuando esté listo para obtener resultados en modo Live.