مین مواد پر جائیں

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

درخواست کا مواد​

فیلڈقسملازمیوضاحت
filefileہاںتوثیق کے لیے 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

درخواست کا مواد​

فیلڈقسملازمیوضاحت
filefileہاںپراسیس کرنے کے لیے CSV فائل۔
responseFormatstringنہیں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 key موجود نہیں​

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

غلط API key​

{
  "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"
}