স্কিপ করে মূল কন্টেন্ট এ যান

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 কী নেই​

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