API de detección de imágenes IA
API de detección de imágenes IA y de ediciones locales.
Detecte generación con IA y ediciones locales en sus imágenes con dos llamadas a la API. Regiones marcadas e informe verificable, 1,99 US$ por imagen.
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
- fvimg-2 · FVIMG V2
- Archivos admitidos
- JPEG, PNG, WEBP
- Tamaño máximo
- Hasta 10 MB y 40 megapíxeles
- Resultado
- En la misma solicitud o mediante webhook
- Precio
- 1,99 US$ por comprobación de imagen
Última actualización
Qué comprueba
Qué preguntas responde la comprobación de imágenes.
¿Se generó la imagen entera? ¿Se editó una parte? ¿Qué dicen los propios registros del archivo? Un solo informe responde a las tres, y la columna «Campo de la respuesta» indica dónde leer cada respuesta.
| Pregunta | Qué se examina | Campo de la respuesta |
|---|---|---|
| Generación con IA | Si la imagen parece generada, con una probabilidad y, cuando es posible, el generador probable. | questions.ai, generator |
| Ediciones locales | Si se modificó una parte de la imagen, con las regiones marcadas en píxeles. | questions.edit, regions |
| Content Credentials, marcas de agua y etiquetas de IA | Lo que afirman los propios registros del archivo sobre su origen, y si esas afirmaciones se sostienen. | questions.source, provenance |
| Metadatos del archivo | La cámara, el software y la hora de captura que figuran en los registros del archivo. | provenance |
| Veredicto y confianza | Un nivel de riesgo, una acción recomendada y cuánto permite establecer este archivo. | summary, confidence |
Solicitud y respuesta
Dos llamadas y un informe.
Suba la imagen y cree después la comprobación con el modelo fvimg-2. Envíe Prefer: wait para mantener la solicitud abierta hasta que el informe esté listo. Si la espera se agota antes, la comprobación responde 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=@claim-photo.jpg | 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\": \"fvimg-2\", \"file\": \"$FILE_ID\", \"metadata\": {\"order_id\": \"A-10492\"}}"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("claim-photo.jpg")], { type: "image/jpeg" }), "claim-photo.jpg");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: "fvimg-2", file: file.id, metadata: { order_id: "A-10492" } }),});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("claim-photo.jpg", "rb")}).json() response = requests.post( "https://api.fileverity.com/v1/analyses", headers={**headers, "Idempotency-Key": str(uuid.uuid4()), "Prefer": "wait=60"}, json={"model": "fvimg-2", "file": file["id"], "metadata": {"order_id": "A-10492"}},)analysis = response.json()print(analysis["status"], analysis["summary"], analysis["report_url"]){ "id": "an_8Hk2pQ4vN9sL1xR7cW3mY6zB", "object": "analysis", "created": 1793700120, "model": "fvimg-2-2026-10-30", "livemode": true, "status": "succeeded", "file": { "name": "claim-photo.jpg", "bytes": 2481920, "format": "jpeg" }, "report_id": "FV-7K2M-9QXD-4T8R", "report_url": "https://fileverity.com/verify/FV-7K2M-9QXD-4T8R", "summary": { "level": "L2", "assessment": "authentic_untouched", "action": "accept", "ai": "very_low", "edit": "none" }, "result": { "report": { "schema": "fileverity.report/1", "id": "FV-7K2M-9QXD-4T8R" }, "stamped_at": 1793700130 }, "error": null, "progress": null, "usage": { "amount": 199, "currency": "usd", "funding": "balance" }, "metadata": { "order_id": "A-10492" }, "completed_at": 1793700131, "expires_at": 1794304931}Dónde encaja
Póngala donde una imagen se convierte en evidencia.
La API devuelve un nivel de riesgo y una acción recomendada. La decisión final sigue en manos de su equipo.
Fotos de siniestros y seguros
- Usted envía
- Fotos de daños, vehículos y bienes presentadas con un siniestro.
- Usted recibe
- Hallazgos sobre generación con IA y ediciones locales, regiones marcadas y un ID de informe.
- Después, su equipo
- Pida el archivo original u otra foto cuando el informe señale la imagen.
Devoluciones y solicitudes de reembolso
- Usted envía
- Fotos de productos que los clientes suben para respaldar un reembolso.
- Usted recibe
- Un veredicto y una acción recomendada en la respuesta, con las regiones editadas marcadas.
- Después, su equipo
- Retenga el reembolso para revisarlo si se señala una imagen y tramite el resto con normalidad.
Marketplaces y anuncios
- Usted envía
- Fotos de anuncios e imágenes de perfil en el momento de subirlas.
- Usted recibe
- Un nivel de riesgo y una acción recomendada a partir de una sola comprobación.
- Después, su equipo
- Etiquete, limite o revise las subidas señaladas según su propia política.
Disputas e investigaciones
- Usted envía
- Fotos presentadas como prueba en una disputa o una investigación.
- Usted recibe
- Un informe con huellas y una marca de tiempo RFC 3161 que se puede verificar más adelante.
- Después, su equipo
- Guarde el ID del informe con el caso y comparta la página de verificación cuando haga falta.
Límites
Lo que no hace.
Un resultado limpio acota una revisión, pero no la sustituye.
- Solo comprueba imágenes fijas. No analiza vídeo ni audio, no identifica personas y no compara rostros.
- Un resultado sin hallazgos no prueba que una imagen sea auténtica. Volver a fotografiar la imagen, hacer capturas de pantalla o recodificarla elimina indicios.
- Las capturas de pantalla, la compresión fuerte y las imágenes pequeñas limitan lo que se puede establecer. El informe indica cuánto permitió el archivo.
- La ausencia de Content Credentials o de marcas de agua no prueba nada en ningún sentido, porque los metadatos suelen eliminarse al compartir imágenes.
- Los resultados de detección varían según el generador y la imagen. Lea el informe como evidencia para una revisión, no como un veredicto.
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 imágenes generadas con IA mediante la API?
Suba la imagen con POST /v1/files y cree después una comprobación con POST /v1/analyses y el modelo fvimg-2. La respuesta incluye el hallazgo sobre generación con IA, las regiones editadas, el estado de las Content Credentials y un ID de informe que cualquiera puede verificar.
¿Encuentra las partes editadas de una foto?
Sí. La comprobación indica si se modificó una parte de la imagen y marca las regiones en píxeles, para que un revisor vea exactamente lo que se señaló. Las ediciones locales y la generación con IA de la imagen entera se informan por separado.
¿Puede decir qué generador creó una imagen?
Cuando es posible, el informe nombra el generador probable y cómo se identificó. Muchas imágenes no dan ninguno, y que falte un nombre no significa que la imagen sea auténtica.
¿Lee las Content Credentials y las marcas de agua?
Sí. Lee las Content Credentials, las marcas de agua y las etiquetas de IA registradas en el archivo e informa de su estado. Su ausencia no es indicio de autenticidad, porque los metadatos suelen eliminarse al compartir imágenes.
¿Funcionan las capturas de pantalla y las imágenes comprimidas?
Puede enviarlas, pero las capturas de pantalla, la compresión fuerte y el cambio de tamaño eliminan indicios. El informe indica cuánto permitió establecer el archivo, así que trate con cautela los resultados de baja confianza.
¿Cuánto cuesta una comprobación de imagen?
1,99 US$ por comprobación de imagen, que se descuentan de un saldo prepago del espacio de trabajo que usted recarga desde 19 US$. Su primer espacio de trabajo empieza con 5 comprobaciones gratuitas de imágenes o documentos, y las claves de prueba nunca se cobran. Las comprobaciones fallidas no se cobran.
¿Qué formatos y tamaños de imagen se admiten?
Formatos admitidos: JPEG, PNG, WEBP. Los límites son 10 MB y 40 megapíxeles por imagen. Los archivos de hasta 4 MB se envían en una sola solicitud multipart; los más grandes usan una URL de subida prefirmada.
¿Comprueba vídeo, audio o rostros?
No. Solo comprueba imágenes fijas, no compara rostros ni identifica personas. Para documentos, use la API de detección de fraude documental.
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.
Imágenes
Cómo saber si una imagen está hecha con IA
Compruebe el origen de una imagen con el rastreo de la fuente, las Credenciales de contenido, las marcas de agua y el análisis de contenido generado con IA. Con un caso práctico.
21 min de lectura ·
Imágenes
¿Se pueden verificar capturas de pantalla y fotos comprimidas?
Qué cambian una captura, WhatsApp y la compresión, qué archivo pedir, cómo leer un resultado limitado y cuándo solicitar el original u otra prueba.
17 min de lectura ·
Siniestros y devoluciones
Fraude al seguro con IA: cómo revisar las fotos de un siniestro
Revise las fotos de un siniestro con un método basado en pruebas y un caso práctico, y separe el hallazgo sobre la imagen de la decisión sobre el fraude.
19 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.