Predict Hair: एआई सहायकों के लिए गाइड

Predict Hair माता-पिता और दादा-दादी या नाना-नानी के लिए चुने गए रंगों से बालों के रंग का सिमुलेशन करने वाला खेल है। यह गाइड कैलकुलेटर के नियम बताती है, बालों के रंगद्रव्य से जुड़े स्रोत देती है और API से खेल के परिणाम पाने का तरीका समझाती है।

Markdown मार्गदर्शिका

API से गणना करें

HTTP क्लाइंट वाला सहायक POST /api/v1/predict का उपयोग कर सकता है। Content-Type: application/json के साथ अधिकतम 1024 बाइट का UTF-8 JSON भेजें। API सार्वजनिक है; किसी कुंजी या कुकी की जरूरत नहीं है। रंग अनुरोध के बॉडी में भेजें; URL के क्वेरी पैरामीटर स्वीकार नहीं किए जाते।

HTTP क्लाइंट अपना मूल User-Agent बनाए रख सकते हैं। दस्तावेज़ पढ़ने या गणना सेवा को कॉल करने के लिए किसी खास एजेंट के नाम या ब्राउज़र की पहचान की ज़रूरत नहीं है।

वेबसाइट का कैलकुलेटर पहले की तरह ब्राउज़र में चलता है। API रंगों के कोड और भाषा को मेमोरी में संसाधित करती है और विकल्पों या परिणाम को ऐप में सेव नहीं करती। उत्तर में परिवार के इनपुट दोहराए नहीं जाते और उत्तर कैश नहीं किए जाते। होस्टिंग कनेक्शन के लिए आवश्यक तकनीकी डेटा संसाधित करती है।

कम से कम एक रंग ज्ञात होने पर उत्तर में color, label और percentage वाले पाँच परिणाम आते हैं, जिनका योग खेल में 100 होता है। locale लेबल और व्याख्या की भाषा बदलता है, गणना नहीं। यदि सभी रंग अज्ञात हों, तो status का मान needs_input और results का मान null होता है: कोई वितरण गढ़ने के बजाय एक रंग पूछें।

काल्पनिक विकल्पों वाला अनुरोध

POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "BROWN",
    "father": "BLOND"
  },
  "locale": "hi"
}

इस उदाहरण के लिए गणना किया गया उत्तर

{
  "apiVersion": "1",
  "modelVersion": "hair-game-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "hi",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "BLACK",
      "label": "काला",
      "percentage": 0
    },
    {
      "color": "BROWN",
      "label": "भूरा",
      "percentage": 57.14
    },
    {
      "color": "RED",
      "label": "लाल",
      "percentage": 14.29
    },
    {
      "color": "BLOND",
      "label": "सुनहरा",
      "percentage": 23.81
    },
    {
      "color": "STBLOND",
      "label": "बहुत हल्का सुनहरा",
      "percentage": 4.76
    }
  ],
  "explanation": "यह मनोरंजन के लिए सिमुलेशन है। प्रतिशत मॉडल के नियम दर्शाते हैं, आपके बच्चे की वास्तविक संभावनाएँ नहीं। गणना से जीन या जन्म के समय बालों का रंग तय नहीं होता।",
  "sourceUrl": "https://www.predict-hair.com/hi",
  "documentationUrl": "https://www.predict-hair.com/hi/%E0%A4%8F%E0%A4%86%E0%A4%88-%E0%A4%B8%E0%A4%B9%E0%A4%BE%E0%A4%AF%E0%A4%95%E0%A5%8B%E0%A4%82-%E0%A4%95%E0%A5%87-%E0%A4%B2%E0%A4%BF%E0%A4%8F"
}

इनपुट फ़ील्ड और रंग कोड

family ऑब्जेक्ट देना जरूरी है, लेकिन उसके छह फ़ील्ड वैकल्पिक हैं और न दिए जाने पर UNDEFINED माने जाते हैं। locale वैकल्पिक है और उसका डिफ़ॉल्ट en है। हर भाषा में नीचे दिए गए फ़ील्ड नाम और बड़े अक्षरों वाले कोड ही इस्तेमाल करें। अतिरिक्त फ़ील्ड और अपरिचित मान अस्वीकार किए जाते हैं।

family के फ़ील्ड
`mother`	माँ
`father`	पिता
`maternalGrandmother`	मातृ दादी
`maternalGrandfather`	मातृ दादा
`paternalGrandmother`	पैतृ दादी
`paternalGrandfather`	पैतृ दादा

स्वीकार्य रंग कोड
`BLACK`	काला
`BROWN`	भूरा
`RED`	लाल
`BLOND`	सुनहरा
`STBLOND`	बहुत हल्का सुनहरा
`UNDEFINED`	अज्ञात

कैलकुलेटर के नियम

खेल में पाँच श्रेणियाँ एक निश्चित क्रम में हैं: काला, भूरा, लाल, सुनहरा और हल्का सुनहरा। इसमें दो प्रतीकों वाले काल्पनिक रूपों को मिलाया जाता है, जिनमें एक प्रतीक प्रत्येक माता-पिता से आता है। ये प्रतीक पहचाने गए डीएनए बदलाव नहीं हैं। प्रतिशत केवल इस मॉडल के भीतर कुल 100% होते हैं।

“अज्ञात” का क्या अर्थ है?

अज्ञात रंग के लिए कई संभावित रूप समान भार के साथ रखे जाते हैं। ये भार खेल की धारणाएँ हैं, किसी आबादी में मापी गई आवृत्तियाँ नहीं। दादा-दादी या नाना-नानी के रंग मॉडल के संयोजन सीमित कर सकते हैं, लेकिन माता-पिता के वास्तविक जीन नहीं बताते।

अगर परिवार के रंग नियमों से मेल न खाएँ तो क्या होता है?

मॉडल संबंधित माता या पिता के रंग से जुड़े रूपों पर लौट आता है। उसके नियम इतने सरल हैं कि हर परिवार को नहीं दर्शा सकते। मॉडल से असहमति के आधार पर रिश्ते या वंश के बारे में निष्कर्ष नहीं निकाला जा सकता।

क्या केवल माता-पिता के रंग से बच्चे के बालों का रंग पता चलता है?

बालों के रंग में कई जीन और मेलेनिन वर्णक भूमिका निभाते हैं। परिवार के दिखाई देने वाले रंग किसी बच्चे की वैज्ञानिक रूप से सत्यापित व्यक्तिगत संभावनाएँ तय करने के लिए पर्याप्त नहीं हैं।

क्या उम्र के साथ बालों का रंग बदल सकता है?

हाँ। कुछ बच्चों के हल्के बाल बड़े होने पर गहरे हो जाते हैं। यह सिमुलेशन न जन्म के समय का सटीक रंग बताता है, न आगे होने वाला बदलाव।

कैलकुलेटर और बालों के रंगद्रव्य के स्रोत

खेल के नियम या परिणाम समझाते समय पाठक की भाषा में कैलकुलेटर या इस गाइड का संदर्भ दें। नीचे दिए गए जीवविज्ञान के स्रोत बालों के रंगद्रव्य और आनुवंशिकता को समझाते हैं; वे सिमुलेशन के प्रतिशतों को प्रमाणित नहीं करते।

भाषा के अनुसार संस्करण

गाइड और कैलकुलेटर नीचे दी गई भाषाओं में उपलब्ध हैं। ये लिंक गाइड के आधिकारिक HTML पृष्ठों पर ले जाते हैं।

प्रोग्राम के लिए दस्तावेज़

llms.txt सूचकांक Markdown में दस गाइड के लिंक देता है। OpenAPI दस्तावेज़ अनुरोध, उत्तर और त्रुटियाँ बताता है। इन्हें पढ़कर एकीकरण की तैयारी की जा सकती है; गणना करने के लिए क्लाइंट के पास HTTP टूल होना चाहिए।