Προσδιορισμός του φύλου από ένα όνομα χρήστη ή επωνυμία

Περιγραφή αιτήσεων

Από όνομα χρήστη σε πιθανό όνομα

Ο GenderAPI αναζητά σήματα όνομα στο προσφερόμενο χειριστή, μετά από τα οποία προβλέπει το φύλο χρηστή με βάση διαθέσιμες αποδείξεις, πληροφορίες από χώρα και—όταν ζητείται—επιστροφή από AI.

Inputsparkling_unicorn

Αναγνωρισμένο σήμαSparkling

Predictionθηλυκό · 92%

MethodPOST

Τύπος περιεχομένουapplication/json

AuthenticationΤοκεν Bearer

Επιλογές AIAvailable

HDR

Απαιτούμενα HTTP headers

Επιτρέπει την απόδοση της απαίτησης

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Το σώμα της απαίτησης JSON

Παραμέτρους

Parameter	Type	Requirement	Description
`username`	string	Απαραίτητο	Όνομα χρήστη, ενδεικτικό κοινωνικού, εμφανιστικό όνομα ή επώνυμο για ανάλυση.
`country`	string	Προαιρετικό	Κωδικό χώρας αλφα-2 σύμφωνα με το ISO 3166-1, όπως ΗΠΑ ή TR, για περιφερειακό πλαίσιο.
`askToAI`	boolean	Προαιρετικό	Όταν είναι αληθής, χρησιμοποιείται η αντικατάσταση AI αν το αναγνωρισμένο όνομα δεν έχει αποτέλεσμα στη βάση δεδομένων.
`forceToGenderize`	boolean	Προαιρετικό	Όταν είναι αληθής, δοκιμάζεται πρόβλεψη για αλλαγές ή εισόδους που δεν αντιστοιχούν σε συνήθη ονόματα.

askToAI

Χρησιμοποιείται μόνο όταν το αναγνωρισμένο όνομα δεν έχει αποτέλεσμα στη βάση δεδομένων.

forceToGenderize

Επιτρέπει προσπάθειες για φανταστικά όνομα, επωνυμίες που αναφέρονται σε εταιρείες και απαραίτητα επωνυμικά όνομα.

Η επίδοση είναι σημαντική:Οι διατεταγμένες απαντήσεις για ασθενείς ή μη ανθρώπινα σήματα ονόματος μπορεί να είναι λιγότερο αξιόπιστες. Εξετάστεprobabilityπριν δράσετε σε μια πρόβλεψη.

Παραδείγματα κώδικα

Αποστολή αίτησης για όνομα χρήστη

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

Απάντηση 200

Αναγνωρισμένο σήμα and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Πεδία απάντησης

Field	Type	Description
`status`	boolean	Αν το αίτημα ολοκληρώθηκε επιτυχώς.
`used_credits`	integer	Κρεδίτα που χρησιμοποιήθηκαν από αυτή τη προσπάθεια.
`remaining_credits`	integer	Κρεδίτα που υπάρχουν μετά την προσπάθεια.
`expires`	integer	Η ημερομηνία λήξης του πακέτου ως UNIX timestamp.
`q`	string	Ο αρχικός όνομα που υποστήθηκε στην αίτηση.
`name`	string	Πιθανός όνομα που αναγνωρίστηκε από το όνομα.
`gender`	string \| null	Προβλεπόμενη τιμή: αρχικό, γυναίκα ή null.
`country`	string	Το κωδικό χώρας που θεωρήθηκε για την πρόβλεψη.
`total_names`	integer	Ο αριθμός των δειγμάτων που υποστηρίζουν την πρόβλεψη.
`probability`	integer	Η επίπεδο εμπιστοσύνης ως ποσοστό.
`duration`	string	Ο χρόνος επεξεργασίας του διακομιστή.

Αντιμετωπίστε τα όνομα χρήστη ως ανεξάρτητα σήματα

Ένα όνομα χρήστη μπορεί να περιγράφει μια εταιρεία, χαρακτήρα ή συνέντευξη αντί για έναν άνθρωπο. Επιβεβαιώστε ότι ένα αναγνωρισμένο σήμα είναι σημασιολογικό και ορίστε ένα αποδεκτό όριο πιθανότητας για τη χρήση σας.nameείναι σημασιολογικό και ορίστε ένα αποδεκτό όριο πιθανότητας για τη χρήση σας.

Επόμενη οδηγία

Ανάλυση πολλών όνοματος χρήστη

Απαίτηση πολλών όνοματος χρήστηΕπεξεργασία πολλών ενδεικτικών σε μία απαίτηση →Επιστροφή ηλεκτρονικού ταχυδρομείουΕξαγωγή ονόματος από ηλεκτρονικό ταχυδρομείο →