Dentro del motor de coincidencias de HumMatch: presentamos la API de HumMatch

Cualquier aplicación de música puede decirte qué es popular. Casi ninguna puede decirte qué puedes cantar tú, específicamente.

Esa segunda pregunta es la que HumMatch fue construido para responder, y responderla bien resulta requerir algo que casi nadie en la industria de la música se ha molestado en recolectar: datos vocales medidos. Hoy queremos mostrarte, a grandes rasgos, cómo piensa nuestro motor de coincidencias, y anunciar algo en lo que hemos trabajado por un tiempo: la API de HumMatch, para que otros productos también puedan construir sobre ella.

Los datos por debajo

El motor empieza con dos conjuntos de datos que hemos construido desde el primer día.

Canciones. El catálogo de HumMatch ahora cubre más de 25,000 canciones, más de 10,000 con un rango vocal investigado: el rango real de notas que pide la voz principal, con fuente y nivel de confianza en vez de adivinado por género. Esa es la diferencia entre "esto es una canción pop" y "este coro vive entre G3 y G4 y nunca pide más".

Voces. Junto al catálogo, mantenemos una base de datos creciente de perfiles vocales de artistas medidos, construida a partir del análisis de grabaciones reales. Estos van mucho más allá de un simple par de nota más baja/nota más alta: capturan la tesitura (la banda donde una voz realmente pasa su tiempo), características de timbre (la textura medible que hace que dos voces con el mismo rango suenen completamente distintas), e incrustaciones de voz (embeddings): huellas numéricas que nos dejan comparar voces como un mapa compara ubicaciones.

Cuando tarareas tres notas en HumMatch, estás creando tu propia entrada en ese segundo conjunto de datos: un Vocal ID que se puede comparar contra cada canción y cada perfil de artista que tenemos.

Qué pesa realmente la puntuación de coincidencia

Un comparador ingenuo revisa una sola cosa: ¿la nota más alta de la canción está por debajo de tu nota más alta? Esa prueba deja pasar demasiadas canciones que van a doler, y falla la pregunta que importa: ¿se va a sentir bien cantar esta canción?

Nuestra puntuación de coincidencia es de varios factores. Sin abrir el capó por completo, las grandes ideas son:

• Superposición de zona cómoda. Cuánto de la canción cae dentro de la banda donde vive tu voz (no los extremos que técnicamente puedes alcanzar, sino el rango donde puedes quedarte toda la noche).
• Penalizaciones por notas imposibles de cantar. Las notas por encima de tu techo o por debajo de tu piso no solo bajan la puntuación con cortesía. Son la diferencia entre una canción que interpretas y una canción que sobrevives, y el motor las trata así.
• Distancia al centro. Qué tan lejos está el centro de gravedad melódico de la canción respecto al centro de tu rango cómodo. Una canción puede solaparse con tu zona cómoda y aun así pasar la mayor parte de su tiempo en el extremo incómodo de ella.
• Similitud en el espacio de voces. Usando esos perfiles de artistas medidos, el motor puede hacer una pregunta más sutil: ¿qué tan cerca está tu voz, como un punto en un espacio de muchas dimensiones, de la voz que hizo famosa esta canción? Dos voces que se agrupan tienden a favorecer el mismo tipo de material.

Un ejemplo resuelto: dos canciones, ambas "en rango"

Supongamos que el rango completo de un cantante va de E3 a C5, y su zona cómoda (donde la voz realmente vive) es A3 a A4. Ahora considera dos canciones:

• Canción A va de E4 a C5. Técnicamente cada nota está dentro del rango del cantante.
• Canción B va de G3 a G4. También está completamente dentro del rango del cantante.

Un comparador que solo mira el rango se encoge de hombros: las dos pasan. Nuestro motor prefiere claramente la Canción B, y los números explican por qué.

En la línea numérica musical (donde cada paso es un semitono), la zona cómoda A3–A4 abarca 12 pasos. El rango de la Canción B, G3–G4, se solapa con esa zona cómoda en 10 de sus 12 semitonos, cerca del 83% de la canción vive donde vive la voz. La Canción A se solapa solo en 5 de sus 8 semitonos, y la parte que no se solapa es la peor parte: sus notas más altas llegan justo hasta C5, el techo absoluto del cantante. Eso significa que cada coro se canta al borde mismo de lo físicamente posible. Sin margen, sin espacio para una noche larga o una segunda toma.

Esa es la diferencia entre "en rango" y "en tu voz". La Canción A es un desafío. La Canción B es un partido en casa.

Presentamos la API de HumMatch

Aquí está el anuncio: el motor de coincidencias ya no es solo nuestro. La API de socios de HumMatch expone la misma lógica de ajuste vocal que impulsa hummatch.me, como endpoints limpios y sin estado:

• Perfiles vocales. Envía un rango vocal (nombres de notas como "C3"/"A4", o números MIDI directos) o datos derivados de un tarareo, y recibe un perfil vocal normalizado: tipo de voz, etiqueta de tono, y un Vocal ID reutilizable.
• Ajuste de canción. Puntúa cualquier canción de nuestro catálogo contra un perfil y recibe una puntuación de coincidencia real, más la misma explicación en lenguaje simple de "por qué encaja" que HumMatch muestra a los cantantes en el sitio.
• Ajuste grupal. Envía dos o más perfiles y recibe el rango vocal compartido del grupo con canciones candidatas ordenadas, la misma lógica detrás de SquadMatch, calculada por completo con los datos que envías.

Cada llamada es un cálculo en tiempo real más una consulta de solo lectura al catálogo. No guardamos lo que envías más allá de la propia clave de API.

Gratis para quienes construyen, empresarial para plataformas

El nivel gratis ya está activo hoy. Desarrolladores y aficionados pueden obtener por su cuenta una clave de prueba desde la página de desarrolladores en una sola petición. Sin formulario de registro, sin cola de aprobación, la clave se emite al instante, con límites de uso razonables. Si alguna vez quisiste agregar "¿puede este usuario realmente cantar esto?" a un proyecto, puedes tenerlo funcionando esta misma tarde.

El nivel empresarial es para productos. Plataformas de karaoke que quieren filas de canciones más inteligentes. Aplicaciones de música que quieren recomendaciones basadas en la voz real de quien escucha. Herramientas de entrenamiento vocal que quieren datos medibles de rango y progreso. Dueños de catálogos que quieren saber qué públicos pueden cantar sus canciones. Para claves en producción, límites más altos, y apoyo de integración, estamos abriendo activamente conversaciones de alianza. Contáctanos por nuestro formulario de contacto y menciona acceso a la API.

Hacia dónde va esto

La ruta desde aquí trata de profundidad. Conforme crece la plataforma, planeamos buscar integraciones de catálogo más profundas y ampliaciones de datos con licencia: datos vocales más ricos a nivel de canción, cobertura más amplia entre idiomas y géneros, y relaciones más cercanas con quienes son dueños y administran catálogos. La dirección es simple: HumMatch quiere ser la capa de ajuste vocal para donde sea que la música se encuentre con una voz humana.

Empezó con tararear tres notas en un navegador. Se está convirtiendo en infraestructura.