ForHosting KIT · Imágenes

Cuente los colores únicos de una imagen y vea los cinco principales

El contador de colores únicos convierte muestras de píxeles RGB en un inventario claro de los colores realmente presentes.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Informa del número exacto de ternas RGB distintas, del total de píxeles representados y de los cinco colores más frecuentes. Los registros repetidos se combinan automáticamente, y un recuento opcional permite que una muestra represente muchos píxeles idénticos. El cálculo es determinista y emplea valores exactos de canal, sin agrupar tonos cercanos, por lo que resulta útil para gráficos exportados, imágenes indexadas, capturas y pruebas donde importa la igualdad precisa.

Prepare muestras de píxeles para un recuento exacto

Proporcione los píxeles como registros RGB con canales rojo, verde y azul entre 0 y 255. Cada registro representa un píxel salvo que añada un recuento positivo, útil cuando un decodificador o histograma ya ha agrupado valores repetidos. La herramienta considera único un color solo cuando cambia su terna RGB completa. Por ejemplo, RGB 20, 40, 60 y RGB 20, 40, 61 son dos colores distintos aunque parezcan casi iguales. El canal alfa queda deliberadamente fuera del contrato, así que las muestras deben reflejar previamente la política de transparencia o composición de su flujo. Puede enviar el mismo valor RGB varias veces; todas las apariciones y recuentos se suman antes de ordenar. Así se admiten tanto secuencias de píxeles sin procesar como histogramas compactos sin alterar el significado. Una lista vacía no describe ninguna muestra y genera un error, no un cero engañoso. También se rechazan canales o recuentos inválidos, campos no admitidos y listas excesivas para que los problemas de formato sean visibles.

Interprete los colores distintos y la clasificación de los cinco primeros

El total de colores distintos es el tamaño del mapa de frecuencias RGB exactas tras combinar registros duplicados. El total de píxeles suma el recuento de cada registro y usa uno cuando se omite. La lista principal contiene como máximo cinco elementos y puede incluir menos si existen menos de cinco colores únicos. Se ordena del recuento mayor al menor. Si dos colores empatan, aparecen primero los valores menores de rojo, después verde y finalmente azul, lo que estabiliza el resultado entre llamadas y equipos. Cada elemento incluye notación hexadecimal en mayúsculas, canales RGB originales, recuento absoluto y frecuencia respecto del total representado. La frecuencia se redondea a seis decimales para producir JSON compacto y repetible. No es un extractor de paletas perceptivas: los tonos vecinos permanecen separados en vez de mezclarse en un centro de grupo. Esta diferencia importa al comprobar recursos indexados, detectar colores imprevistos por suavizado o confirmar la salida exacta de una transformación. Use una herramienta de agrupación de paletas cuando la similitud visual importe más que la identidad exacta.

Aplique el resultado en auditorías, optimización y pruebas

El recuento de colores es un diagnóstico compacto para canalizaciones gráficas. Antes de publicar un icono, compare el total distinto con el tamaño previsto de la paleta; un aumento inesperado puede revelar suavizado, un modo de exportación incorrecto o un fondo aplanado con valores ligeramente diferentes. Para compresión, las cinco frecuencias principales muestran si pocos colores dominan la imagen y pueden orientar una posterior codificación indexada o reducción de paleta. En pruebas automatizadas, guarde el total y los colores principales como aserciones después de renderizar, redimensionar o convertir formatos, recordando que cualquier interpolación puede crear legítimamente valores RGB nuevos. El campo de recuento también facilita el uso con decodificadores del servidor que ya producen histogramas, pues pueden enviar un registro por color observado. Esta capacidad no obtiene ni decodifica archivos: su aplicación aporta las muestras. El proceso es local y determinista, sin red, azar ni estado conservado. Puede realizar comprobaciones interactivas en el navegador o integrar la misma operación mediante API por $0.002.

Audite un gráfico indexado

Confirme que un icono o sprite exportado no contiene más colores RGB exactos que su paleta prevista.

Detecte tonos de renderizado inesperados

Localice colores adicionales introducidos por suavizado, interpolación, composición o cambios de exportación.

Resuma el histograma de un decodificador

Convierta registros RGB ponderados en un recuento exacto y una lista estable de las cinco frecuencias principales.

¿Qué se considera un color distinto?

Una combinación única de canales enteros rojo, verde y azul. La diferencia de un solo canal crea otro color.

¿La herramienta agrupa colores parecidos?

No. Compara valores RGB exactos y nunca une tonos cercanos. Use una paleta dominante para agrupación perceptiva.

¿Para qué sirve el campo de recuento?

Permite que un registro RGB represente varios píxeles idénticos. Si se omite, representa un píxel.

¿Qué ocurre si hay menos de cinco colores?

La lista top_colors devuelve todos los colores observados, por lo que tendrá menos de cinco elementos.

¿Cuánto cuesta una solicitud de API?

Cada solicitud de API cuesta $0.002. El mismo cálculo determinista también puede ejecutarse en el navegador.

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.

POSThttps://api.kit.forhosting.com/image/color-count

¿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, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/image/color-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pixels":[{"r":255,"g":0,"b":0,"count":4},{"r":0,"g":0,"b":255,"count":2},{"r":255,"g":0,"b":0}]}'
{
  "pixels": [
    {
      "r": 255,
      "g": 0,
      "b": 0,
      "count": 4
    },
    {
      "r": 0,
      "g": 0,
      "b": 255,
      "count": 2
    },
    {
      "r": 255,
      "g": 0,
      "b": 0
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.color_count",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb15
max_megapixels12
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →