POST /api/v1/detect/image

API de detección de imágenes IA

Sube una imagen y obtén un veredicto. Si el archivo lleva credenciales de contenido firmadas, las verificamos criptográficamente: una prueba, no una probabilidad. Si no las lleva, el modelo de detección analiza los píxeles.

1.000 créditos gratis · sin tarjeta · PNG, JPG, GIF, WebP hasta 10 MB

POST/api/v1/detect/image
curl -X POST https://www.wasitaigenerated.com/api/v1/detect/image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Content-Type — multipart/form-data

file — obligatorio, PNG · JPG · JPEG · GIF · WebP

Tamaño máx. — 10 MB por petición

Coste — 300 créditos por imagen

200 OK — application/json
{
  "isAI": true,
  "confidence": 0.99,
  "verified": true,
  "c2pa": {
    "vendor": "OpenAI",
    "generator": "ChatGPT",
    "issuer": "OpenAI",
    "signedAt": "2024-08-06T21:53:37+00:00",
    "signatureValid": true,
    "sourceType": "trainedAlgorithmicMedia",
    "isAI": true
  },
  "patterns": [
    "ai_verified",
    "c2pa_signed",
    "synthetic_artifacts"
  ],
  "analysis": {
    "likelihood": "high",
    "reasoning": "AI-generated imagery detected with 99.0%
      confidence. Verified AI-generated: content
      credentials signed by ChatGPT (OpenAI) on 2024-08-06."
  },
  "detailed": {
    "scores": { "ai": 99.0, "human": 1.0 },
    "model": "v1.1"
  }
}

Dos señales, una respuesta

La mayoría de los detectores de imágenes te dan una probabilidad y te dejan solo para defenderla. Este endpoint te dice cuándo tiene una prueba real.

Lee las pruebas detrás de una imagen

Ilustración del flujo
Imagen de ejemplo · solo ilustración

Análisis del modelo

Una estimación basada en la propia imagen. Lee la confianza junto con la valoración IA/humano.

Credenciales de contenido

Si existen, revisa la firma C2PA y el origen declarado. Comprueba qué acredita realmente la credencial.

Flujo ilustrativo de revisión de imágenes, no una imagen analizada. La confianza del modelo y las credenciales de contenido son señales distintas; la ausencia de credenciales no demuestra autoría humana.
verified: true

Verificación criptográfica

Los generadores que siguen el estándar C2PA firman su contenido con credenciales de contenido. Si esas credenciales están intactas, validamos la firma: la imagen está generada por IA, y eso no es una cuestión de criterio.

Úsala cuando necesites un resultado que puedas presentar a un cliente, un moderador o un regulador.

verified: false

Análisis del modelo

La mayoría de las imágenes que circulan han pasado por capturas de pantalla, recompresiones o han perdido sus metadatos. En esos casos, el modelo de detección analiza los píxeles y devuelve una confianza y un reparto IA/humano.

Una prueba sólida, pero fija un umbral y mantén a una persona en el proceso para los casos límite.

Intégrala en minutos

Subida multipart, autenticación Bearer, respuesta JSON

curl -X POST https://www.wasitaigenerated.com/api/v1/detect/image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Campos de la respuesta

  • isAI — veredicto booleano.
  • confidence — 0–1, según el modelo de detección.
  • verified — true cuando unas credenciales de contenido firmadas demuestran que la imagen se generó con IA.
  • patterns[] — etiquetas legibles por máquina, como ai_verified o synthetic_artifacts.
  • detailed.scores — probabilidad IA frente a humano, en porcentaje.

Qué construyen los equipos con ella

Seguros y siniestros

Revisa fotos de daños y recibos al recibirlos, antes de que un perito dedique tiempo a un siniestro basado en pruebas generadas. Ver el caso de uso

Trust & safety

Puntúa cada imagen que suben tus usuarios en cuanto llega y envía automáticamente los medios sintéticos a tu cola de moderación.

💘

Citas y redes sociales

Detecta fotos de perfil generadas en el registro, donde frenar cuentas falsas sale más barato. Ver el caso de uso

🪪

KYC y onboarding

Marca imágenes sintéticas de documentos de identidad durante la verificación, junto a tus comprobaciones de prueba de vida.

Redacciones

Verifica las imágenes enviadas por usuarios y de agencias antes de publicarlas, y registra el resultado en tu historial de auditoría editorial.

Marketplaces

Detecta fotos de producto generadas que no se corresponden con lo que el vendedor envía realmente.

Respuestas de error

Cada fallo es un cuerpo JSON con un campo error

400 Bad Request
Falta el campo file, formato no compatible o supera el límite de 10 MB.
401 Unauthorized
Token Bearer ausente o no válido.
402 Payment Required
Créditos insuficientes (insufficient_credits): quedan menos de 300. La respuesta incluye required y available.
403 Forbidden
plan_without_api: Pro solo funciona en la web. La API funciona con créditos, API Business o Enterprise.
413 Payload Too Large
Imagen demasiado grande: redúcela antes de subirla.
429 Too Many Requests
Más de 120 peticiones por minuto por API key. Reintenta tras el tiempo indicado en la cabecera Retry-After.
500 Server Error
Reintenta con backoff o contacta con soporte.

Precios de la detección de imágenes

300 créditos por imagen, sin suscripción para empezar.

Gratis

1.000

créditos al verificar tu email

3 imágenes para probar el endpoint. Sin tarjeta.

MÁS POPULAR

Paquetes de créditos

desde 10 $

pago único, no caducan

50.000 créditos ≈ 166 imágenes. 1.500.000 créditos ≈ 5.000 imágenes.

API Business

299 $/mes

3 M de créditos de API y MCP al mes

Todo lo de Pro más la API y el servidor MCP, informes PDF de marca blanca y soporte prioritario. Cancela cuando quieras.

Preguntas frecuentes sobre la API de detección de imágenes IA

¿Qué devuelve la API de detección de imágenes IA?

Un objeto JSON con isAI (booleano), confidence (0–1), verified (booleano), c2pa (la credencial de contenido procesada o null), un breve análisis y detailed.scores con las probabilidades IA y humano en porcentaje. El indicador clave es verified: si es true, la imagen lleva una credencial de contenido con firma válida que la declara generada por IA, así que el resultado es un hecho y no una probabilidad. Además, c2pa te dice quién la firmó (vendor e issuer, p. ej. OpenAI), con qué generador (p. ej. ChatGPT) y cuándo.

¿Qué diferencia hay entre verified y confidence?

confidence es la probabilidad, según el modelo de detección, de que la imagen sea sintética: útil, pero estadística. verified significa que la imagen lleva una credencial de contenido C2PA cuya firma es válida y que declara el archivo como generado por IA, lo que lo demuestra. El manifiesto completo se devuelve en c2pa: issuer es el emisor del certificado y no se puede falsificar, signatureValid es la comprobación criptográfica y sourceType indica si la credencial declara generación por IA (trainedAlgorithmicMedia) o una captura de cámara (digitalCapture). Trata verified: true como algo seguro y confidence como una prueba sólida que, en los casos límite, merece una decisión humana.

¿Qué generadores detecta?

Imágenes de la generación actual de modelos de difusión y transformers: Midjourney, DALL·E, Stable Diffusion, Flux, Firefly, Imagen y las herramientas construidas sobre ellos. Los generadores que incrustan credenciales de contenido se detectan además por verificación criptográfica, con independencia de lo que vea el modelo visual.

¿Qué formatos y tamaños se admiten?

PNG, JPG, JPEG, GIF y WebP, hasta 10 MB por petición. Envía la imagen como multipart/form-data con el nombre de campo file. Las imágenes muy grandes pueden toparse con un límite de tamaño previo: redúcelas a unos pocos megabytes para un rendimiento más fiable.

¿Cuánto cuesta la detección de imágenes?

300 créditos por imagen. Una cuenta nueva verificada empieza con 1.000 créditos gratis, que cubren tres imágenes de prueba. A partir de ahí, el paquete de 10 $ con 50.000 créditos da para unas 166 imágenes, el de 49 $ con 300.000 para 1.000 y el de 199 $ con 1.500.000 para 5.000. Para un volumen constante, API Business cuesta 299 $/mes con 3.000.000 de créditos cada mes (≈ 3 millones de palabras o 10.000 imágenes), informes PDF de marca blanca y soporte prioritario; el exceso se descuenta de los paquetes de créditos.

¿Volver a guardar o comprimir una imagen afecta a la detección?

La compresión fuerte, los recortes y las capturas de pantalla eliminan señal, y las capturas borran por completo las credenciales de contenido. Por eso la captura de una imagen IA puede devolver verified: false y c2pa: null. Copiar una imagen al portapapeles tiene el mismo efecto. Envía el archivo original siempre que lo tengas y trata una copia recodificada como una prueba más débil.

¿Puedo usarla para moderar contenido a gran escala?

Sí. Llama al endpoint al subir cada archivo, guarda el veredicto junto a él y envía todo lo que supere tu umbral de confianza a tu cola de moderación. Para un volumen constante, API Business (299 $/mes) incluye 3.000.000 de créditos (≈ 10.000 imágenes) cada mes; consúltanos sobre Enterprise si necesitas más volumen, un SLA, límites a medida o una licencia para integrar la detección en tu propio producto.

¿Se conservan las imágenes subidas?

Las imágenes enviadas a través de la API se procesan para generar un resultado y no se usan para entrenar nuestros modelos. Consulta la política de privacidad para conocer todos los detalles sobre la conservación de datos.

¿Listo para añadir detección de imágenes?

Crea una cuenta, verifica tu email y tu API key te estará esperando en el panel.