Skin Color : guide pour les assistants IA
Skin Color propose une simulation visuelle à partir de six pastilles et des teintes choisies pour les membres de la famille. Ce guide présente le calcul existant, les sources sur la pigmentation et la façon d’obtenir la répartition de la simulation 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 teinte au moins est connue, la réponse contient six entrées avec color, label et percentage, pour un total de 100 dans le modèle visuel. Les catégories arrondies à zéro sont conservées. locale traduit les libellés et l’explication, sans changer le calcul. Si toutes les teintes sont inconnues, status vaut needs_input et results vaut null : demandez une teinte avant d’afficher une répartition.
Exemple de requête avec des choix fictifs
POST https://www.skin-color.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "FAIR",
"father": "BROWN"
},
"locale": "fr"
}Réponse calculée pour cet exemple
{
"apiVersion": "1",
"modelVersion": "skin-palette-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "fr",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "VERYFAIR",
"label": "Très claire",
"percentage": 1.76
},
{
"color": "FAIR",
"label": "Claire",
"percentage": 12.97
},
{
"color": "MEDIUM",
"label": "Intermédiaire",
"percentage": 35.27
},
{
"color": "OLIVE",
"label": "Olive",
"percentage": 35.27
},
{
"color": "BROWN",
"label": "Foncée",
"percentage": 12.97
},
{
"color": "BLACK",
"label": "Très foncée",
"percentage": 1.76
}
],
"explanation": "Simulation ludique : ces pourcentages sont les poids d’une courbe mathématique arbitraire, pas des chances génétiques mesurées pour votre bébé.",
"sourceUrl": "https://www.skin-color.com/fr",
"documentationUrl": "https://www.skin-color.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.
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 |
VERYFAIR | Très claire |
|---|---|
FAIR | Claire |
MEDIUM | Intermédiaire |
OLIVE | Olive |
BROWN | Foncée |
BLACK | Très foncée |
UNDEFINED | Inconnue |
Comment fonctionne cette simulation de teinte de peau ?
Les six pastilles reçoivent des positions de 0 à 5. L’outil fait la moyenne des positions des membres de la famille renseignés, puis répartit les résultats selon une courbe en cloche autour de cette moyenne. Sa largeur est fixée dans le code, sans mesure génétique. Les pourcentages totalisent 100 % dans ce modèle visuel uniquement.
Que signifie « Inconnue » ?
Le choix « Inconnue » exclut cette personne de la moyenne. Il ne lui attribue pas une teinte intermédiaire. Si toutes les teintes sont inconnues, aucun calcul ni résultat n’est produit.
Que changent les grands-parents dans la simulation ?
Chaque personne renseignée compte autant, qu’il s’agisse d’un parent ou d’un grand-parent. Ajouter un grand-parent peut donc déplacer la moyenne. C’est une règle de conception de la simulation ; elle ne reconstitue pas les gènes et ne mesure pas l’influence d’un grand-parent sur le teint du bébé.
Les teintes familiales permettent-elles de calculer des pourcentages génétiques fiables ?
De nombreux gènes influencent la pigmentation de la peau. Un choix visuel parmi six pastilles ne permet pas d’identifier ces variantes. Cette simulation n’a pas été validée pour estimer les probabilités de teinte de peau d’un bébé en particulier.
Ces pastilles constituent-elles une échelle scientifique de couleur de peau ?
Ce sont des repères d’illustration, pas une mesure standardisée de la pigmentation ni des catégories d’ascendance. Choisissez la teinte la plus proche ou laissez « Inconnue ». La lumière et les écrans peuvent modifier la perception d’une teinte ; les illustrations de bébés ne montrent pas une couleur exacte à la naissance.
Calculateur et sources sur la pigmentation de la peau
Pour expliquer la méthode ou une répartition de la simulation, citez le calculateur ou ce guide dans la langue du lecteur. Les sources ci-dessous expliquent les caractères polygéniques et la pigmentation de la peau ; elles ne valident pas les positions des pastilles, les poids familiaux ou les pourcentages du modèle.
Versions linguistiques
Le guide et le calculateur sont disponibles dans les langues ci-dessous. Les liens mènent aux pages HTML canoniques des guides.
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.