Predict Hair: guía para asistentes de IA
Predict Hair ofrece un juego de simulación del color del cabello a partir de los colores elegidos para los padres y los abuelos. Esta guía explica las reglas de la calculadora, reúne fuentes sobre la pigmentación y muestra cómo obtener los resultados del juego mediante una API.
Calcular con la API
Un asistente con un cliente HTTP puede llamar a POST /api/v1/predict. Envíe un objeto JSON UTF-8 de un máximo de 1024 bytes, con Content-Type: application/json. La API es pública y no requiere clave ni cookie. Los colores deben enviarse en el cuerpo; los parámetros de la URL se rechazan.
Los clientes HTTP pueden conservar su User-Agent original. No hace falta usar un nombre de agente específico ni identificarse como un navegador para leer los documentos o llamar al servicio de cálculo.
La calculadora web sigue funcionando en el navegador. La API recibe los códigos de color y el idioma, los procesa en memoria y no guarda las opciones ni el resultado en la aplicación. Las respuestas no reproducen los datos familiares y no se almacenan en caché. El alojamiento procesa los datos técnicos necesarios para las conexiones.
Si se conoce al menos un color, la respuesta contiene cinco entradas con color, label y percentage, que suman 100 dentro del juego. locale traduce las etiquetas y la explicación sin cambiar el cálculo. Si todos los colores son desconocidos, status es needs_input y results es null: pide un color en lugar de inventar una distribución.
Ejemplo de petición con opciones ficticias
POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "BROWN",
"father": "BLOND"
},
"locale": "es"
}Respuesta calculada para este ejemplo
{
"apiVersion": "1",
"modelVersion": "hair-game-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "es",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "BLACK",
"label": "Negro",
"percentage": 0
},
{
"color": "BROWN",
"label": "Castaño",
"percentage": 57.14
},
{
"color": "RED",
"label": "Rojo",
"percentage": 14.29
},
{
"color": "BLOND",
"label": "Rubio",
"percentage": 23.81
},
{
"color": "STBLOND",
"label": "Rubio claro",
"percentage": 4.76
}
],
"explanation": "Simulación de entretenimiento: los porcentajes describen las reglas del modelo, no las posibilidades reales de tu bebé. El cálculo no identifica genes ni determina el color al nacer.",
"sourceUrl": "https://www.predict-hair.com/es",
"documentationUrl": "https://www.predict-hair.com/es/para-asistentes-ia"
}Campos y códigos de entrada
El objeto family es obligatorio, pero cada uno de sus seis campos es opcional y toma el valor UNDEFINED si se omite. locale es opcional y su valor predeterminado es en. Use los nombres exactos y los códigos en mayúsculas que aparecen abajo, en cualquier idioma. Se rechazan los campos adicionales y los valores no reconocidos.
mother | Madre |
|---|---|
father | Padre |
maternalGrandmother | Abuela materna |
maternalGrandfather | Abuelo materno |
paternalGrandmother | Abuela paterna |
paternalGrandfather | Abuelo paterno |
BLACK | Negro |
|---|---|
BROWN | Castaño |
RED | Rojo |
BLOND | Rubio |
STBLOND | Rubio claro |
UNDEFINED | Desconocido |
Reglas utilizadas por la calculadora
El juego utiliza cinco categorías y una prioridad fija: negro, castaño, pelirrojo, rubio y rubio claro. Combina perfiles ficticios de dos símbolos, uno transmitido por cada progenitor. Los símbolos no representan variantes de ADN identificadas. Los porcentajes suman el 100 % únicamente dentro de este modelo.
¿Qué significa «Desconocido»?
Un color desconocido deja varios perfiles posibles con el mismo peso. Son supuestos del juego, no frecuencias medidas en una población. Los abuelos pueden limitar las combinaciones del modelo, pero no revelan los genes reales de los padres.
¿Qué ocurre si los colores familiares no encajan en las reglas?
El modelo vuelve a los perfiles asociados al color del progenitor correspondiente. Sus reglas son demasiado simples para representar a todas las familias. Una discrepancia no permite sacar conclusiones sobre la filiación.
¿Bastan los colores de los padres para predecir el pelo del bebé?
La pigmentación del pelo depende de muchos genes y de los pigmentos de melanina. Los colores visibles de la familia no bastan para establecer probabilidades individuales validadas.
¿Puede cambiar el color del pelo con la edad?
Sí. El pelo claro de algunos niños se oscurece al crecer. Esta simulación no predice el color preciso al nacer ni su evolución.
Calculadora y fuentes sobre la pigmentación
Para explicar las reglas o un resultado del juego, cita la calculadora o esta guía en el idioma del lector. Las fuentes biológicas que aparecen a continuación explican la pigmentación y la herencia del cabello; no validan los porcentajes de la simulación.
Versiones por idioma
La guía y la calculadora están disponibles en los siguientes idiomas. Los enlaces llevan a las páginas HTML canónicas de las guías.
Documentos para programas
El índice llms.txt enlaza las diez guías en Markdown. El contrato OpenAPI describe la petición, las respuestas y los errores. Estos documentos permiten preparar una integración; el cliente necesita una herramienta HTTP para ejecutar un cálculo.