V2 में source का क्या मतलब है?
source फ़ील्ड बताता है कि अंतिम परिणाम किस रास्ते से बना: संग्रहीत डेटासेट की खोज, AI अनुमान या कोई स्रोत नहीं चुना गया। यह किसी रिकॉर्ड के मूल प्रकाशक की ओर इशारा नहीं करता, लाइसेंस का सबूत नहीं है और अनुमान के सही होने की गारंटी नहीं देता।
यह गाइड V2 रिस्पॉन्स के मौजूदा नियम और GenderAPI.io की खुद तैयार की गई डेटाबेस प्रोफ़ाइल बताती है। नीचे दिए गए अवलोकन इन्वेंटरी और संगति की जाँचें हैं; मूल स्रोतों की सत्यापित सूची और सटीकता का स्वतंत्र मूल्यांकन अभी प्रकाशित नहीं हुए हैं।
| source | अर्थ | यह क्या नहीं बताता |
|---|---|---|
dataset | एक संग्रहीत रिकॉर्ड चुना गया; गिनतियाँ बराबर होने पर लिंग फिर भी अज्ञात रह सकता है | मूल प्रकाशक, संग्रह का तरीका, लाइसेंस, रिकॉर्ड कितना ताज़ा है या अवलोकन एक-दूसरे से स्वतंत्र हैं या नहीं |
ai | अंतिम जवाब कॉन्फ़िगर किए गए AI अनुमान के रास्ते से आया; gender फिर भी null हो सकता है | गिनती का सैंपल, डेटासेट का संदर्भ या अनुमान की कैलिब्रेट की गई सटीकता |
none | सिर्फ़ डेटासेट वाले मोड में अंतिम परिणाम के लिए कोई संग्रहीत रिकॉर्ड नहीं चुना गया | यह कि इनपुट का किसी भी जनसंख्या या भाषा में कोई संभावित नाम संबंध नहीं है |
डेटाबेस प्रोफ़ाइल: 26 सितंबर 2026
कलेक्शन का मेटाडेटा 2026-09-26T15:28:18.227Z पर पढ़ा गया और बेतरतीब सैंपल 2026-09-26T15:31:54.045Z पर लिए गए। दस्तावेज़ों की दोनों संख्याएँ संबंधित कलेक्शन के MongoDB collStats मेटाडेटा से आती हैं, अलग से की गई पूरी गिनती से नहीं। सामान्य कलेक्शन में नामों के रिकॉर्ड हैं और देश-विशेष कलेक्शन में नाम और देश के संयोजन। इन दोनों संख्याओं को जोड़कर यूनिक नामों या यूनिक लोगों की कुल संख्या न निकालें।
हर कलेक्शन के लिए MongoDB ने बेतरतीब ढंग से 5,000 दस्तावेज़ चुने और नीचे दी गई कुल जाँचें डेटाबेस सर्वर पर की गईं। सार्वजनिक रिपोर्ट में कोई नाम या मूल डेटा शामिल नहीं है। ये GenderAPI.io के प्रोडक्शन डेटाबेस पर किए गए अपने अवलोकन हैं, कोई स्वतंत्र ऑडिट या स्थिर मूल्यांकन डेटासेट नहीं। ये जाँचें गिनतियों की संगति देखती हैं, अनुमान की सटीकता, यूनिक लोगों या नामों की संख्या या API के कवरेज को नहीं।
| अवलोकन | सामान्य रिकॉर्ड | देश-विशेष रिकॉर्ड |
|---|---|---|
| कलेक्शन | general | country-specific |
| मेटाडेटा में दस्तावेज़ों की संख्या | 24,83,220 | 40,80,692 |
| संग्रहीत यूनिक कुंजी | name | name + country |
| बेतरतीब ढंग से चुने गए दस्तावेज़ | 5,000 | 5,000 |
| सैंपल में विफल संख्यात्मक जाँचें | 0 | 0 |
| सैंपल में male + female का total से अलग होना | 0 | 0 |
| सैंपल में male और female की बराबर गिनती | 124 | 94 |
| सैंपल में updated_at फ़ील्ड मौजूद | 667 / 5,000 | 741 / 5,000 |
डेटाबेस की जाँचें क्या दिखाती हैं
संख्यात्मक जाँच के लिए ज़रूरी है कि total एक पॉज़िटिव सुरक्षित पूर्णांक हो और male और female की गिनतियाँ सीमित मान हों जो शून्य और total के बीच हों। एक अलग जाँच male + female की तुलना total से करती है। सैंपल की सभी गिनतियाँ इन जाँचों में सफल रहीं; इसका मतलब यह नहीं कि कलेक्शन के सभी रिकॉर्ड संगत हैं या कोई अनुमान सही है।
सामान्य कलेक्शन के सैंपल में 124 और देश-विशेष कलेक्शन के सैंपल में 94 रिकॉर्ड में male और female की गिनती बराबर थी। ये संग्रहीत गिनतियों की बराबरी है, स्वतंत्र रूप से सत्यापित अस्पष्ट पहचान या API के अज्ञात परिणामों की दर नहीं। API का असल परिणाम इनपुट, Redis की उपलब्धता, कैंडिडेट के चुनाव और AI विकल्पों पर निर्भर करता है।
2026-09-26T15:33:13.811Z पर सामान्य कलेक्शन के country फ़ील्ड की एक अलग इन्वेंटरी में 244 अलग-अलग संग्रहीत मान मिले: इनमें से 239 दो बड़े अक्षरों वाले प्रारूप में थे और 5 दूसरे प्रारूप में। ISO के अनुरूप होना, देश के हिसाब से रिकॉर्ड का वितरण और समर्थित देशों का कवरेज मापा नहीं गया। ये संख्याएँ समर्थित देशों की संख्या नहीं हैं।
दोनों सैंपल में कोई स्रोत या लाइसेंस फ़ील्ड नहीं मिला। इससे यह साबित नहीं होता कि हर रिकॉर्ड या बाहरी सिस्टम में स्रोत की जानकारी नहीं है: किसी फ़ील्ड का होना या न होना स्रोत के लाइसेंस को साबित नहीं करता। कुछ रिकॉर्ड में संख्या के रूप में updated_at फ़ील्ड मौजूद है, लेकिन उसके मान और अर्थ की जाँच नहीं हुई है; इससे डेटा के ताज़ा होने या अपडेट के शेड्यूल का पता नहीं चलता।
V2 डेटासेट खोज Redis से करता है। 26 सितंबर 2026 को GenderAPI.io ने सिस्टम प्रबंधक के रूप में पुष्टि की कि MongoDB और Redis में एक ही डेटासेट है। यह समानता इसी पुष्टि पर आधारित है: दोनों डेटाबेस की स्वतंत्र तुलना अभी नहीं हुई है और यह जाँच अभी बाकी है। ऊपर दी गई इन्वेंटरी संग्रहीत रिकॉर्ड का वर्णन करती है; API रिस्पॉन्स का कवरेज भेजे गए इनपुट, कैंडिडेट मिलान और AI विकल्पों पर भी निर्भर करता है। सैंपल किसी तय सीड के बिना लिए गए, पढ़ते समय कोई स्थिर स्नैपशॉट नहीं था और प्रोसेसिंग में कोई स्वतंत्र संदर्भ लेबल नहीं थे; इनसे अनुमान की सटीकता, कैलिब्रेशन या जवाब का कवरेज नहीं मापा जा सकता।
रिस्पॉन्स में साक्ष्य को ट्रैक करें
| फ़ील्ड | अर्थ | सीमा |
|---|---|---|
input | भेजे गए प्रकार, मान और देश के संदर्भ को दोहराता है | इनपुट मान स्वतंत्र रूप से सत्यापित पहचान की जानकारी नहीं है |
match.name / match.method | चुना गया कैंडिडेट दिखाता है और यह भी कि वह नॉर्मलाइज़ किया गया, टोकन या सबस्ट्रिंग के रूप में निकाला गया या मॉडल ने अनुमान लगाया | किसी टोकन से मिलान इसकी गारंटी नहीं देता कि पूरे नाम या यूज़रनेम से असली पहला नाम निकाला गया |
match.scope / match.country | दिखाता है कि चुना गया रिकॉर्ड देश-विशेष खोज से आया या ग्लोबल खोज से | देश देने से इसकी गारंटी नहीं मिलती कि उस देश का विशेष रिकॉर्ड मौजूद है |
sample_count | चुने गए रिकॉर्ड की संग्रहीत कुल गिनती; AI अनुमान में null | ज़रूरी नहीं कि यह यूनिक लोगों, स्वतंत्र रूप से जुटाए गए अवलोकनों या सटीकता मूल्यांकन के सैंपल आकार को दर्शाए |
confidence / confidence_kind | संग्रहीत गिनतियों से निकाले गए अनुपात और मॉडल के बताए गए मान में अंतर करता है | दोनों में से कोई भी किसी व्यक्ति की लैंगिक पहचान की सत्यापित संभावना नहीं है |
country / country_source | लौटाए गए रिकॉर्ड का देश मेटाडेटा या AI का बताया गया नाम और देश का संबंध (अगर हो) | राष्ट्रीयता, निवास या सत्यापित मूल नहीं बताता और यह भी साबित नहीं करता कि भेजा गया देश मेल खा गया |
इनपुट मिलान परिणाम पर कैसे असर डालता है
डेटासेट खोज टेक्स्ट को नॉर्मलाइज़ करती है और उससे कैंडिडेट निकालती है। ईमेल पतों के लिए कैंडिडेट @ से पहले वाले हिस्से से आते हैं; यूज़रनेम की शुरुआत में वैकल्पिक @ हटा दिया जाता है। ईमेल पतों और यूज़रनेम की सामान्य खोज सीमित सबस्ट्रिंग भी जाँच सकती है। कई कैंडिडेट रिकॉर्ड होने पर सबसे ज़्यादा संग्रहीत कुल गिनती वाला रिकॉर्ड चुना जाता है। वह चाहे गए नाम से अलग हिस्सा भी हो सकता है।
देश का संदर्भ देने पर खोज हर कैंडिडेट के लिए देश-विशेष रिकॉर्ड जाँचती है और वह न हो तो ग्लोबल रिकॉर्ड। अंतिम परिणाम चुना गया मिलान दिखाता है। अस्पष्ट देश-विशेष रिकॉर्ड अपने-आप उस कैंडिडेट के ग्लोबल रिकॉर्ड से नहीं बदला जाता।
सामान्य AI प्रॉम्प्ट पहचाने जा सकने वाले पहले नाम खोजता है। forceToGenderize निजी निकनेम या छद्मनाम के ज़रिए संबंध बनाने की भी अनुमति देता है: इस मोड में non-null लिंग के साथ name: null एक मान्य परिणाम है। यह अनुमान का अलग काम है और इसका आकलन अलग से होना चाहिए।
डेटासेट खोज और AI प्रोसेसिंग
AI इस्तेमाल होने पर V2 भेजा गया type, value और देश का संदर्भ कॉन्फ़िगर की गई AI अनुमान सेवा को भेजता है। ईमेल पतों के लिए प्रॉम्प्ट मॉडल से डोमेन और प्लस के बाद वाले हिस्से को अनदेखा करने को कहता है; इसकी गारंटी नहीं है कि AI प्रोसेसिंग से पहले ये अक्षर मान से हटा दिए गए हैं। अगर आपके वर्कफ़्लो को सिर्फ़ डेटासेट वाला अनुमान चाहिए, तो forceToGenderize के बिना ai_mode: off इस्तेमाल करें।
AI रिस्पॉन्स का सत्यापन JSON फ़ील्ड, उनके प्रकार और फ़ील्ड के बीच की संगति जाँचता है। इससे यह साबित नहीं होता कि लौटाया गया नाम, लिंग संबंध या देश संबंध सही है। सार्वजनिक परिणाम में मॉडल की पहचान या संस्करण शामिल नहीं होता, न ही अनुमान के पक्ष में कोई स्रोत।
| विकल्प | अनुमान का रास्ता | लौटाया गया साक्ष्य |
|---|---|---|
| ai_mode: off | सिर्फ़ डेटासेट खोज | चुने गए रिकॉर्ड का मेटाडेटा या कोई रिकॉर्ड न चुने जाने पर अज्ञात परिणाम |
| ai_mode: fallback | पहले डेटासेट खोज; लिंग न मिलने पर AI | अंतिम रास्ते का साक्ष्य, डेटासेट और AI को मिलाकर बना सैंपल नहीं |
| ai_mode: always | सीधे कॉन्फ़िगर किए गए AI अनुमान का रास्ता | मॉडल का बताया गया मान या null confidence वाला अज्ञात परिणाम; sample_count हमेशा null |
| forceToGenderize: true | डेटासेट खोज, परिणाम न मिलने पर निकनेम को ध्यान में रखने वाला AI | डेटासेट का साक्ष्य या मॉडल का बताया गया निकनेम पर आधारित संबंध; name null हो सकता है |
स्रोतों का दस्तावेज़ीकरण जो अभी प्रकाशित नहीं हुआ है
यहाँ स्रोतों की कोई सत्यापित सूची प्रकाशित नहीं है। सिर्फ़ रिस्पॉन्स के नियमों और लागू किए गए व्यवहार से डेटा की उत्पत्ति, स्रोत के इस्तेमाल के अधिकार, प्रतिनिधित्व या लेबल की गुणवत्ता का सत्यापन नहीं हो सकता। किसी खास स्रोत के बारे में दावा करने से पहले नीचे दी गई जानकारी दर्ज और सत्यापित करनी होगी।
दस्तावेज़ों की यह समीक्षा यह तय नहीं करती कि मूल स्रोत लाइसेंस के दायरे में हैं या पूरे हैं। यह सार्वजनिक रूप से उपलब्ध साक्ष्य की सीमाएँ बताती है। अगर आपके उपयोग के मामले में किसी खास स्रोत का आकलन ज़रूरी है, तो GenderAPI.io से संपर्क करें।
| साक्ष्य | ज़रूरी दस्तावेज़ीकरण | सार्वजनिक स्थिति |
|---|---|---|
| उत्पत्ति और इस्तेमाल के अधिकार | नामित स्रोत या प्रकाशक, संग्रह की अवधि, लाइसेंस या इस्तेमाल का कोई दूसरा दर्ज आधार | यहाँ कोई सत्यापित सूची प्रकाशित नहीं है |
| प्रोसेसिंग का इतिहास | रूपांतरण, नॉर्मलाइज़ेशन, डुप्लिकेट हटाना, कुल योग और कोई भी सिंथेटिक या मॉडल से बना योगदान | source: dataset लेबल में नहीं दिखता |
| जनसंख्या का कवरेज | देश और लिपि का कवरेज, चुनने की प्रक्रिया, लेबल की परिभाषाएँ और दर्ज पूर्वाग्रह | यहाँ स्वतंत्र रूप से आकलित कवरेज डेटा प्रकाशित नहीं है |
| ताज़गी | स्नैपशॉट की पहचान, हर स्रोत की अपडेट की तारीख और उससे जुड़ा अपडेट शेड्यूल | V2 रिस्पॉन्स में हर रिकॉर्ड की ताज़गी या स्नैपशॉट की पहचान शामिल नहीं होती |
| गुणवत्ता और सुधार | सत्यापन के परिणाम, ओवरलैप जाँच, सुधार और हटाने के अनुरोधों को संभालना और समीक्षा की ज़िम्मेदारी | यहाँ स्रोत के हिसाब से ऑडिट के परिणाम प्रकाशित नहीं हैं |
डेटा सुरक्षा, प्रोसेसिंग और ज़िम्मेदार इस्तेमाल
स्रोत की उत्पत्ति, निजी डेटा की प्रोसेसिंग और कानूनी शर्तें अलग-अलग सवाल हैं। प्रोसेसिंग में भूमिकाएँ, डेटा रखने की अवधि, सेवा प्रदाता और अनुबंध की शर्तें मौजूदा प्रकाशित नीतियों के अनुसार हैं। यह तकनीकी गाइड डेटा रखने की कोई नई प्रतिबद्धता नहीं जोड़ती और कानूनों के पालन का सबूत नहीं है।
सिर्फ़ वही डेटा भेजें जिसकी आपके वर्कफ़्लो को ज़रूरत है। कॉन्फिडेंस का प्रकार और अज्ञात परिणाम सुरक्षित रखें और अनुमान को व्यक्ति की खुद बताई गई पहचान के रूप में पेश न करें। किसी व्यक्ति के बारे में महत्वपूर्ण फ़ैसलों का आधार अनुमानित लिंग को न बनाएँ।
सटीकता का साक्ष्य और बदलावों का इतिहास
स्रोत लेबल अनुमान का रास्ता बताता है, अनुमान की मापी गई गुणवत्ता नहीं। सटीकता वाली गाइड बताती है कि रिस्पॉन्स के मानों, जवाब के कवरेज और त्रुटियों को कैसे अलग रखें और दोहराए जा सकने वाले मूल्यांकन के लिए कौन-सी जानकारी ज़रूरी है।
| तारीख | दस्तावेज़ संस्करण | बदलाव |
|---|---|---|
| 2026-09-29 | 1.0.0 | तारीख वाली MongoDB इन्वेंटरी, सैंपल की संगति जाँचों, V2 के source और match फ़ील्ड, AI प्रोसेसिंग की सीमाओं और स्रोत सूची में बाकी कमियों का हिंदी संस्करण। MongoDB और Redis की समानता 26 सितंबर 2026 को GenderAPI.io की दी गई पुष्टि पर आधारित है; स्वतंत्र तुलना अभी बाकी है। कोई सटीकता प्रतिशत या स्रोत लाइसेंस के बारे में कोई दावा नहीं जोड़ा गया। |