Documentación de la API de Fileverity
Descripción general
La API de Fileverity comprueba imágenes, documentos y texto sin formato para detectar generación con IA, manipulación y pasajes escritos con IA. URL base, modelos, convenciones y por dónde empezar.
La API de Fileverity permite que su software compruebe imágenes, documentos y texto sin formato con los modelos de Fileverity. Una sola clave de API y un único saldo de prepago del espacio de trabajo cubren todos los modelos. Los resultados de imágenes y documentos son los mismos informes que genera el sitio web, cada uno con un ID de informe, una marca de tiempo RFC 3161 y una página de verificación pública.
¿Es la primera vez? Siga el Inicio rápido para hacer su primera llamada en unos minutos, o obtenga una clave de prueba y llame a la API de inmediato. Para una descripción general del producto, consulte la página de la API, la API de detección de imágenes IA y la API de detección de fraude documental.
Modelos
| Modelo | Qué comprueba | Cómo se invoca |
|---|---|---|
fvimg-2 (FVIMG V2) | Imágenes: generación con IA, ediciones locales, Credenciales de contenido y metadatos. Descripción general: API de detección de imágenes IA | Suba el archivo con POST /files y después llame a POST /analyses |
fvdoc-3 (FVDOC V3) | Documentos: texto escrito con IA, fotos incrustadas, historial de ediciones y firmas. Descripción general: API de detección de fraude documental | Suba el archivo con POST /files y después llame a POST /analyses |
fvdoc-3-text (FVDOC V3 Text) | Texto sin formato: escrito con IA, escrito en parte con IA o escrito por una persona, con los pasajes escritos con IA marcados | Una llamada síncrona a POST /text/detections |
Los precios, los límites y los ID de versión fechada figuran en Precios y facturación.
Convenciones
- URL base.
https://api.fileverity.com/v1. Solo HTTPS. - Formato. Las solicitudes son JSON, salvo la subida de archivos, que es multipart. Las respuestas son JSON, salvo el informe en PDF. Las marcas de tiempo se expresan en segundos Unix, salvo dentro de
result.report, donde las horas están en formato ISO 8601 y en UTC. - Autenticación. Una clave de API Bearer en el encabezado
Authorization. Consulte Autenticación y claves. - ID. Los objetos llevan un prefijo:
file_para archivos,an_para análisis,tdet_para detecciones de texto,evt_para eventos de webhook yreq_para solicitudes. Los ID de informe tienen el formatoFV-XXXX-XXXX-XXXX. - ID de solicitud. Cada respuesta incluye un encabezado
x-request-idy cada error repite ese valor comoerror.request_id. Indíquelo al contactar con soporte. - Comprobaciones, análisis e informes. Una comprobación es lo que usted ejecuta y paga: una comprobación de imagen, de documento o de texto. En la API, un análisis es una comprobación de imagen o de documento, y una detección de texto es una comprobación de texto. Las comprobaciones de imagen y de documento producen un informe completo; una comprobación de texto produce un resultado.
- Versionado. La versión va en la URL. Se pueden añadir campos y endpoints nuevos a v1, así que ignore los campos que no reconozca. Un ID de modelo como
fvimg-2apunta a una versión fechada (fvimg-2-2026-10-30). Los resultados indican la versión que los produjo, y puede fijar una solicitud a una versión concreta pasando su ID comomodel. - Idiomas. La detección de texto admite en, fr, de, es y zh.
Especificación OpenAPI
La API se describe en un documento OpenAPI 3.1 en https://api.fileverity.com/v1/openapi.json. La referencia de la API se genera a partir de ese documento, por lo que ambos siempre coinciden. El documento se puede cargar desde un navegador, de modo que herramientas como Swagger UI y Postman pueden importarlo mediante su URL, y GET https://api.fileverity.com/v1 devuelve enlaces a esta documentación y a la especificación.
Qué contiene esta documentación
- Inicio rápido: del registro al primer resultado.
- Autenticación y claves: claves Live y Test, revocación y límites de gasto.
- Detecciones de texto, Archivos y Análisis: las formas de ejecutar una comprobación.
- Webhooks e Idempotencia: comportamiento en producción.
- Código de ejemplo: programas completos en Node.js y Python para cada comprobación y para los webhooks.
- Comprobaciones de documentos en un flujo de recepción: subida, webhook, derivación según el nivel de riesgo, revisión humana y verificación posterior.
- Errores y Límites de frecuencia y encabezados.
- Precios y facturación y Conservación de datos y seguridad.
- Registro de cambios y la referencia de la API.
Las mismas comprobaciones en el navegador
No necesita la API para ejecutar una comprobación. El sitio web ofrece Analizar una imagen, Verificación documental y Verificación de imágenes, y la Consola ejecuta las tres comprobaciones con cargo al saldo de su espacio de trabajo.
Soporte
Escriba a hello@fileverity.com o use la página de contacto, e indique el ID de solicitud (x-request-id), la hora en UTC y el endpoint. Los fallos temporales devuelven 503 service_unavailable con un encabezado retry-after y nunca se cobran. ¿Necesita límites más altos o precios por volumen? Hable con ventas.
Cómo leer esta documentación con un agente
Cada página también está disponible como Markdown: añada .md a su ruta, por ejemplo /es/docs/quickstart.md. El índice de todas las páginas está en /es/docs/llms.txt.