मुख्य कंटेंट तक स्किप करें

CSV नाम जानकारी API

CSV फ़ाइल प्रोसेस करने से पहले उसे सत्यापित करें, फिर हर पंक्ति में लिंग, आयु, जातीयता और भाषा के अनुमान जोड़ें।

बेस URL​

https://api.genderrecognition.com

CSV फ़ॉर्मैट​

CSV फ़ाइलों में पहले नाम और उपनाम के कॉलम होने चाहिए। बैकएंड camelCase और snake_case, दोनों प्रकार के कॉलम नाम स्वीकार करता है।

firstName,lastName
Alex,Morgan
Jamie,Patel

अपलोड के लिए file फ़ील्ड का उपयोग करें; फ़ाइल 10 MB या उससे छोटी होनी चाहिए।

सत्यापन एंडपॉइंट​

POST /v1/voice-gender-recognition/api/csv/validate

हेडर​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
fileफ़ाइलहाँसत्यापन के लिए CSV फ़ाइल।

उदाहरण​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv/validate" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv"

प्रतिक्रिया​

{
  "success": true,
  "message": "CSV file validated successfully",
  "csvInfo": {
    "rowCount": 2,
    "headers": ["firstName", "lastName"],
    "sampleData": [
      {
        "firstName": "Alex",
        "lastName": "Morgan"
      }
    ]
  },
  "userInfo": {
    "remainingRequests": 2999,
    "canProcess": true
  }
}

प्रोसेसिंग एंडपॉइंट​

POST /v1/voice-gender-recognition/api/csv

हेडर​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
fileफ़ाइलहाँप्रोसेस करने के लिए CSV फ़ाइल।
responseFormatटेक्स्टनहींCSV फ़ाइल पाने के लिए csv दें। डिफ़ॉल्ट आउटपुट JSON है।

JSON प्रतिक्रिया का उदाहरण​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv"
{
  "success": true,
  "message": "Successfully processed 2 rows",
  "data": [
    {
      "firstName": "Alex",
      "lastName": "Morgan",
      "gender": "male",
      "genderProbability": 0.86,
      "age": "25-34",
      "ageProbability": 0.78,
      "ethnicity": "English",
      "ethnicityProbability": 0.74,
      "language": "English",
      "languageProbability": 0.8
    }
  ],
  "summary": {
    "totalRows": 2,
    "processedRows": 2,
    "remainingRequests": 2997
  }
}

CSV प्रतिक्रिया का उदाहरण​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv" \
  -F "responseFormat=csv"

जब responseFormat का मान csv हो, API डाउनलोड करने योग्य प्रोसेस की गई फ़ाइल text/csv के रूप में लौटाती है। अन्य मानों पर सामान्य JSON प्रतिक्रिया मिलती है।

त्रुटि स्थितियाँ​

API कुंजी मौजूद नहीं है​

{
  "error": "API key is required"
}

अमान्य API कुंजी​

{
  "error": "Invalid API key"
}

फ़ाइल मौजूद नहीं है​

{
  "error": "No CSV file uploaded"
}

अमान्य फ़ाइल प्रकार​

{
  "error": "Invalid file type. Only .csv format is allowed."
}

CSV के कॉलम अमान्य हैं​

{
  "error": "Invalid CSV format. The file must contain columns named 'firstName' or 'first_name' and 'lastName' or 'last_name'. Found columns: name"
}

कोटा समाप्त हो गया​

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 2, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

प्रोसेसिंग विफल हुई​

{
  "error": "Internal server error"
}