# Predict Hair : guide pour les assistants IA HTML: Predict Hair propose un jeu de simulation de la couleur des cheveux à partir des couleurs choisies pour les parents et les grands-parents. Ce guide présente les règles du calculateur, les sources sur la pigmentation et la façon d’obtenir les résultats du jeu par une API. ## Calculer avec l’API Un assistant disposant d’un client HTTP peut appeler POST /api/v1/predict. Envoyez un objet JSON UTF-8, de 1024 octets au maximum, avec Content-Type: application/json. L’API est publique, sans clé ni cookie. Les couleurs doivent être dans le corps de la requête ; les paramètres d’URL sont refusés. Les clients HTTP peuvent conserver leur User-Agent d’origine. Aucun nom d’agent particulier ni identité de navigateur n’est requis pour lire les documents ou appeler le point de calcul. Le calculateur web continue à fonctionner dans le navigateur. L’API reçoit les codes couleur et la langue, les traite en mémoire et n’enregistre ni les choix ni le résultat dans l’application. Les réponses ne recopient pas la famille et ne sont pas mises en cache. L’hébergement traite les données techniques nécessaires aux connexions. Quand une couleur au moins est connue, la réponse contient cinq entrées avec color, label et percentage, pour un total de 100 dans le jeu. locale traduit les libellés et l’explication, sans changer le calcul. Si toutes les couleurs sont inconnues, status vaut needs\_input et results vaut null : demandez une couleur au lieu d’inventer une répartition. ### Exemple de requête avec des choix fictifs ```http POST https://www.predict-hair.com/api/v1/predict Content-Type: application/json { "family": { "mother": "BROWN", "father": "BLOND" }, "locale": "fr" } ``` ### Réponse calculée pour cet exemple ```json { "apiVersion": "1", "modelVersion": "hair-game-v1", "purpose": "entertainment", "scientificallyValidated": false, "locale": "fr", "status": "ok", "unit": "percent", "results": [ { "color": "BLACK", "label": "Noir", "percentage": 0 }, { "color": "BROWN", "label": "Brun", "percentage": 57.14 }, { "color": "RED", "label": "Roux", "percentage": 14.29 }, { "color": "BLOND", "label": "Blond", "percentage": 23.81 }, { "color": "STBLOND", "label": "Blond clair", "percentage": 4.76 } ], "explanation": "Simulation ludique : ces pourcentages décrivent les règles du modèle, pas les chances réelles pour votre bébé. Le calcul ne permet pas de déterminer ses gènes ni sa couleur à la naissance.", "sourceUrl": "https://www.predict-hair.com/fr", "documentationUrl": "https://www.predict-hair.com/fr/pour-les-assistants-ia" } ``` ## Champs et codes à envoyer L’objet family est obligatoire, mais chacun de ses six champs est facultatif et vaut UNDEFINED s’il est omis. locale est facultatif et vaut en par défaut. Utilisez exactement les noms de champs et les codes en majuscules ci-dessous, quelle que soit la langue. Les champs supplémentaires et les valeurs non reconnues sont refusés. ### Champs de family - `mother`: Mère - `father`: Père - `maternalGrandmother`: Grand-mère maternelle - `maternalGrandfather`: Grand-père maternel - `paternalGrandmother`: Grand-mère paternelle - `paternalGrandfather`: Grand-père paternel ### Codes couleur acceptés - `BLACK`: Noir - `BROWN`: Brun - `RED`: Roux - `BLOND`: Blond - `STBLOND`: Blond clair - `UNDEFINED`: Inconnu ## Les règles utilisées par le calculateur Le jeu utilise cinq catégories et une règle de priorité fixe : noir, brun, roux, blond, blond clair. Il combine des profils fictifs à deux symboles, avec un symbole transmis par chaque parent. Ces symboles ne représentent pas des variantes d’ADN identifiées. Les pourcentages totalisent 100 % au sein de ce modèle uniquement. ## Que signifie « Inconnu » ? Une couleur inconnue laisse plusieurs profils possibles, pondérés de façon égale. Ces poids sont des hypothèses du jeu, pas des fréquences mesurées dans une population. Les grands-parents peuvent préciser les combinaisons du modèle ; ils ne révèlent pas les gènes réels d’un parent. ## Que se passe-t-il si les couleurs familiales ne correspondent pas aux règles ? Le modèle repart alors des profils associés à la couleur du parent concerné. Ses règles sont trop simples pour représenter toutes les familles. Un désaccord avec le modèle ne permet aucune conclusion sur une filiation. ## Peut-on prédire la couleur des cheveux avec les seules couleurs des parents ? La pigmentation des cheveux dépend de nombreux gènes et des pigments mélaniques. Les seules couleurs visibles ne suffisent pas à valider des probabilités individuelles pour un bébé. ## La couleur des cheveux peut-elle changer avec l’âge ? Oui. Les cheveux clairs de certains enfants foncent en grandissant. Cette simulation ne prédit ni la couleur précise à la naissance ni son évolution. ## Calculateur et sources sur la pigmentation Pour présenter les règles ou un résultat du jeu, citez le calculateur ou ce guide dans la langue du lecteur. Les sources biologiques ci-dessous expliquent la pigmentation et l’hérédité des cheveux ; elles ne valident pas les pourcentages de la simulation. - [Calculateur de couleur des cheveux de bébé]() - [Comment fonctionne cette simulation de couleur des cheveux ?]() - [MedlinePlus Genetics — Is hair color determined by genetics?]() - [Morgan et al. (2018), Nature Communications — Genome-wide study of hair colour]() ## Versions linguistiques Le guide et le calculateur sont disponibles dans les langues ci-dessous. Les liens mènent aux pages HTML canoniques des guides. - [العربية]() - [Deutsch]() - [English]() - [Español]() - [Français]() - [हिन्दी]() - [日本語]() - [Português (Brasil)]() - [Русский]() - [中文]() ## Documents pour les programmes L’index llms.txt pointe vers les dix guides en Markdown. Le contrat OpenAPI décrit la requête, les réponses et les erreurs. Lire ces documents permet de préparer une intégration ; le client doit disposer d’un outil HTTP pour exécuter un calcul. - [Guide en Markdown]() - [Contrat OpenAPI]() - [Index llms.txt]() - [Sitemap des pages HTML]() - [Politique de confidentialité]()