# GenderAPI v1 से v2 पर माइग्रेट करें

> समान API कुंजी और संतुलन का उपयोग करके GenderAPI एकीकरण को v1 से v2 पर ले जाएं। मानचित्र अनुरोध फ़ील्ड, बैच मार्ग, प्रतिक्रियाएँ, त्रुटियाँ और पुनः प्रयास व्यवहार।

Canonical HTML: https://www.genderapi.io/hi/docs/v2/migration

Last reviewed: 2026-09-25

## एकीकरण को v1 से v2 पर ले जाएँ

V1 उपलब्ध रहता है. तैयार होने पर एक ही कुंजी और क्रेडिट बैलेंस का उपयोग करके व्यक्तिगत एकीकरण को माइग्रेट करें। V2 एक अलग अनुरोध और प्रतिक्रिया अनुबंध है, इसलिए केवल URL बदलना पर्याप्त नहीं है।

| V1 अवधारणा | V2 समतुल्य |
| --- | --- |
| अलग नाम, ईमेल और उपयोगकर्ता नाम समापन बिंदु | POST /api/v2/gender type और value के साथ |
| एकाधिक समापन बिंदुओं को अलग करें | POST /api/v2/gender/batch items के साथ |
| askToAI | options.ai_mode: fallback; एकल अनुरोध पहले से ही fallback पर डिफ़ॉल्ट हैं |
| forceToGenderize | तीनों प्रकारों के लिए समान वैकल्पिक फ़ील्ड; पहले डेटासेट, फिर उपनाम-जागरूक AI |
| समतल प्रतिक्रिया फ़ील्ड | परिणाम के लिए data; पहुंच और बिलिंग के लिए meta |
| probability प्रतिशत | 0-1 पैमाने पर confidence प्लस confidence_kind; एआई स्कोर कैलिब्रेटेड संभावनाएं नहीं हैं |
| total_names | data.sample_count, अशक्त |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| लीगेसी त्रुटि प्रारूप | HTTP स्थिति प्लस Problem Details code और action |
| POST पुनः प्रयास करें | प्रत्येक पुनः प्रयास सामान्य बिलिंग के साथ एक नया ऑपरेशन है |

- [V1 संदर्भ पढ़ें](https://www.genderapi.io/hi/api-documentation/v1)
- [v2 OpenAPI अनुबंध का उपयोग करें](https://api.genderapi.io/api/v2/openapi.json)

## अपने ग्राहक को अद्यतन और सत्यापित करें

आप जिस एकीकरण को स्थानांतरित कर रहे हैं उसके लिए v2 अनुरोध और प्रतिक्रिया अनुबंध का उपयोग करें। meta.access.mode को सत्यापित करें, JSON null परिणामों को संरक्षित करें, प्रति-आइटम बैच त्रुटियों का निरीक्षण करें और पुनः प्रयास करने से पहले बिलिंग की जांच करें। जब तक उनके क्लाइंट अपडेट नहीं हो जाते, तब तक उनके मौजूदा पथों पर v1 एकीकरण रखें।

- [प्रमाणीकरण से प्रारंभ करें](https://www.genderapi.io/hi/docs/v2/authentication)
- [एक v2 प्रतिक्रिया पढ़ें](https://www.genderapi.io/hi/docs/v2/responses)
- [पुनः प्रयास संभालें](https://www.genderapi.io/hi/docs/v2/errors-and-retries)