Predict Hair: Leitfaden für KI-Assistenten
Predict Hair bietet ein Spiel zur Simulation der Haarfarbe anhand der für Eltern und Großeltern gewählten Farben. Dieser Leitfaden erklärt die Regeln des Rechners, verlinkt Quellen zur Pigmentierung und zeigt, wie sich Spielergebnisse über eine API berechnen lassen.
Mit der API rechnen
Ein Assistent mit HTTP-Client kann POST /api/v1/predict aufrufen. Senden Sie UTF-8-JSON mit höchstens 1024 Bytes und Content-Type: application/json. Die API ist öffentlich und benötigt weder Schlüssel noch Cookie. Farben gehören in den Anfragekörper; URL-Abfrageparameter werden abgewiesen.
HTTP-Clients können ihren ursprünglichen User-Agent beibehalten. Zum Lesen der Dokumente und Aufrufen der Berechnungs-API sind weder ein bestimmter Agentenname noch die Kennung eines Browsers erforderlich.
Der Rechner der Website läuft weiterhin im Browser. Die API nimmt Farbcodes und eine Sprache entgegen, verarbeitet sie im Arbeitsspeicher und speichert weder die Auswahl noch das Ergebnis in der Anwendung. Die Antwort enthält keine Kopie der Familiendaten und wird nicht zwischengespeichert. Das Hosting verarbeitet die für Verbindungen erforderlichen technischen Daten.
Sobald mindestens eine Farbe bekannt ist, enthält die Antwort fünf Einträge mit color, label und percentage. Ihre Summe beträgt im Spiel 100. locale übersetzt Bezeichnungen und Erklärung, ohne die Berechnung zu ändern. Sind alle Farben unbekannt, lautet status needs_input und results ist null: Fragen Sie nach einer Farbe, statt eine Verteilung zu erfinden.
Beispielanfrage mit fiktiver Auswahl
POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "BROWN",
"father": "BLOND"
},
"locale": "de"
}Berechnete Antwort für dieses Beispiel
{
"apiVersion": "1",
"modelVersion": "hair-game-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "de",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "BLACK",
"label": "Schwarz",
"percentage": 0
},
{
"color": "BROWN",
"label": "Braun",
"percentage": 57.14
},
{
"color": "RED",
"label": "Rot",
"percentage": 14.29
},
{
"color": "BLOND",
"label": "Blond",
"percentage": 23.81
},
{
"color": "STBLOND",
"label": "Sehr blond",
"percentage": 4.76
}
],
"explanation": "Spielerische Simulation: Die Prozentwerte beschreiben die Modellregeln, nicht die tatsächlichen Chancen Ihres Babys. Die Berechnung bestimmt weder Gene noch die Haarfarbe bei der Geburt.",
"sourceUrl": "https://www.predict-hair.com/de",
"documentationUrl": "https://www.predict-hair.com/de/fuer-ki-assistenten"
}Eingabefelder und Farbcodes
Das Objekt family ist erforderlich. Seine sechs Felder sind jedoch optional und erhalten ohne Angabe den Wert UNDEFINED. locale ist optional und hat den Standardwert en. Verwenden Sie in jeder Sprache genau die folgenden Feldnamen und großgeschriebenen Codes. Zusätzliche Felder und unbekannte Werte werden abgewiesen.
mother | Mutter |
|---|---|
father | Vater |
maternalGrandmother | Mütterliche Großmutter |
maternalGrandfather | Mütterlicher Großvater |
paternalGrandmother | Väterliche Großmutter |
paternalGrandfather | Väterlicher Großvater |
BLACK | Schwarz |
|---|---|
BROWN | Braun |
RED | Rot |
BLOND | Blond |
STBLOND | Sehr blond |
UNDEFINED | Unbekannt |
Die Regeln des Rechners
Das Spiel verwendet fünf Kategorien mit fester Rangfolge: Schwarz, Braun, Rot, Blond und Hellblond. Es kombiniert fiktive Profile aus zwei Symbolen; ein Symbol stammt jeweils von einem Elternteil. Die Symbole stehen nicht für bestimmte DNA-Varianten. Nur innerhalb dieses Modells ergeben die Prozentwerte zusammen 100 %.
Was bedeutet „Unbekannt“?
Eine unbekannte Farbe lässt mehrere gleich gewichtete Profile zu. Die Gewichte sind Spielannahmen, keine gemessenen Bevölkerungshäufigkeiten. Großeltern können die Kombinationen im Modell einschränken, offenbaren aber nicht die tatsächlichen Gene der Eltern.
Was passiert, wenn die Familienfarben nicht zu den Regeln passen?
Das Modell verwendet dann wieder die Profile zur Farbe des betreffenden Elternteils. Seine Regeln sind zu einfach, um jede Familie abzubilden. Eine Abweichung erlaubt keine Aussage über die Abstammung.
Reichen die Haarfarben der Eltern für eine Vorhersage aus?
Die Haarpigmentierung hängt von vielen Genen und Melaninpigmenten ab. Sichtbare Familienfarben allein reichen nicht aus, um geprüfte individuelle Wahrscheinlichkeiten für ein Baby anzugeben.
Kann sich die Haarfarbe mit dem Alter ändern?
Ja. Bei manchen Kindern werden helle Haare mit dem Älterwerden dunkler. Diese Simulation sagt weder die genaue Farbe bei der Geburt noch ihre Entwicklung voraus.
Rechner und Quellen zur Haarpigmentierung
Verweisen Sie bei Erklärungen zu den Regeln oder einem Spielergebnis auf den Rechner oder diesen Leitfaden in der Sprache des Lesers. Die folgenden biologischen Quellen erklären Haarpigmentierung und Vererbung; sie bestätigen nicht die Prozentwerte der Simulation.
Sprachversionen
Leitfaden und Rechner sind in den folgenden Sprachen verfügbar. Die Links führen zu den kanonischen HTML-Seiten der Leitfäden.
Dokumente für Programme
Der Index llms.txt verlinkt die zehn Markdown-Leitfäden. Die OpenAPI-Beschreibung definiert Anfrage, Antworten und Fehler. Diese Dokumente helfen bei einer Integration; zum Ausführen einer Berechnung benötigt der Client ein HTTP-Werkzeug.