Comparar dos imágenes
Con nuestra API de similitud de imágenes envía dos imágenes y recibe un número que indica cuánto se parecen entre sí, desde duplicados a nivel de píxel hasta composiciones apenas relacionadas. Sirve para el momento exacto en que necesita que una máquina responda si dos archivos son la misma foto, un recorte de ella o algo completamente distinto, sin que una persona tenga que comparar dos pestañas a simple vista.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APIEl problema: dos archivos, una sola pregunta
Quien administra un catálogo, una cola de moderación o un flujo de contenido generado por usuarios tarde o temprano choca con el mismo muro: llegan dos imágenes y alguien tiene que decidir si son duplicados, resubidas, copias con marca de agua o simplemente parecidas por casualidad. Hacer eso a ojo no escala más allá de unas pocas decenas de pares al día. POST /image/compare convierte ese juicio visual en un número repetible y consultable.
Qué envía, qué recibe
Envía dos referencias de imagen en una sola solicitud; la tarea corre de forma asíncrona y devuelve un task_id de inmediato para que su aplicación nunca quede bloqueada esperando el procesamiento. Cuando termina la comparación, recibe una puntuación de similitud junto con la estructura necesaria para definir su propio umbral: un marketplace que detecta publicaciones duplicadas puede tratar 0.9 como coincidencia, mientras que una herramienta de moodboards que compara estilo visual suelto puede aceptar cualquier valor por encima de 0.5.
Por qué comparación perceptual y no comparación de bytes
Dos archivos JPEG de la misma foto guardados con distinta calidad no son idénticos en bytes, y una copia redimensionada o recortada tampoco lo es a nivel de píxel, aunque cualquier persona que mire ambas sepa de inmediato que es la misma imagen. Las técnicas de similitud de imágenes nacieron justamente de esa brecha entre cómo almacenan las computadoras una imagen y cómo la percibe una persona, y evolucionaron desde el hashing simple hasta comparaciones que toleran redimensionamiento, artefactos de compresión y ediciones menores sin dejar de detectar duplicados reales.
Dónde encaja en un flujo automatizado
Como el endpoint es asíncrono y orientado a resultados, se integra sin fricción en trabajos por lotes: un proceso nocturno puede recorrer una biblioteca de medios, comparar los archivos nuevos contra un conjunto de referencia y actuar solo sobre los pares que superan el umbral de similitud, todo sin mantener una conexión abierta. Combinado con un webhook obtiene un flujo de deduplicación totalmente orientado a eventos, en lugar de un script que consulta y espera.
Lo que no hace
Esto es una puntuación de similitud, no un veredicto de reconocimiento facial ni de plagio, y no hace ninguna afirmación sobre derechos de autor, identidad o intención: le dice cuánto se parecen dos imágenes, y usted decide qué significa eso para su producto. Esa honestidad mantiene el resultado predecible, sin porcentajes de confianza inventados, solo una métrica consistente que puede ajustar contra sus propios datos.
Qué puede hacer con ella
Detección de duplicados en marketplaces
Comparar la foto de un producto recién publicado contra las publicaciones existentes para marcar posibles duplicados o listados robados antes de que salgan al aire.
Moderación de contenido generado por usuarios
Revisar las imágenes que suben los usuarios contra un conjunto de imágenes previamente eliminadas para detectar resubidas de contenido ya bloqueado.
Deduplicación de bibliotecas de activos
Recorrer una biblioteca de diseño o medios en busca de archivos casi idénticos guardados con nombres distintos antes de una migración.
Verificación de reutilización y marcas de agua
Comparar una imagen publicada contra una referencia para ver qué tan cerca está un recorte o una reutilización sospechosa del original.
Preguntas frecuentes
¿Cómo entrega los resultados la API de similitud de imágenes?
Cada llamada a POST /image/compare devuelve un task_id de inmediato; la puntuación llega después mediante un webhook firmado o un enlace firmado válido por 24 horas, ya que la comparación se procesa de forma asíncrona.
¿Existe un plan gratuito?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta una comparación?
Cada solicitud cuesta $0.002 más $0.002 por cada imagen comparada, y solo se cobra cuando la tarea se completa con éxito.
¿Qué formatos de imagen acepta?
Se aceptan los formatos rasterizados más comunes; si un archivo enviado no se puede decodificar, la tarea falla de forma controlada y no se cobra.
¿Qué significa la puntuación de similitud?
Es una medida numérica del parecido visual entre las dos imágenes enviadas; usted define el umbral que cuenta como coincidencia para su caso de uso, porque 'duplicado' significa algo distinto en cada producto.
¿Se cobra si la comparación falla?
No. Las tareas fallidas se reintentan automáticamente hasta tres veces y nunca se facturan; solo paga por una comparación completada.
¿Puedo comparar imágenes en volumen?
Sí, envía cada par como una solicitud asíncrona independiente; cada una devuelve su propio task_id para que pueda rastrear y conciliar los resultados por separado.
¿En qué se diferencia de un comparador basado en hash?
Un hash simple se rompe apenas la imagen se redimensiona, se recomprime o se edita levemente; este endpoint está construido para tolerar justamente esas variaciones sin dejar de detectar similitud real.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/image/compare \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/compare", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/imagen.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/compare",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/compare", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/imagen.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/compare", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"image": "https://ejemplo.com/imagen.jpg"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.compare",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 15 |
max_megapixels | 12 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |