Χρήση του αρχικού ονόματος χωρίς την υπόθεση μίας μόνο γραφής ή σταθερής σειράς
Η επίδειξη χρησιμοποιεί ένα παράδειγμα σε ντεβαναγκάρι και το πλαίσιο χώρας IN. Είναι παράδειγμα εισόδου και όχι ορισμός όλων των ονομάτων που χρησιμοποιούνται στην Ινδία. Το API δέχεται συμβολοσειρές Unicode, οπότε μπορείτε να στείλετε τη γραφή που υπάρχει στην εγγραφή της εφαρμογής σας χωρίς να τη μετατρέψετε πρώτα σε λατινικούς χαρακτήρες.
Η αναζήτηση χρησιμοποιεί κανονικοποιημένα μέρη. Δεν κάνει γενική μετατροπή ανάμεσα σε γραφές και δεν εγγυάται ότι μια λατινική γραφή και μια γραφή στο αρχικό αλφάβητο οδηγούν στην ίδια εγγραφή. Διατηρήστε την αρχική είσοδο μαζί με το όνομα που επιστράφηκε. Το ότι μια γραφή γίνεται δεκτή δεν σημαίνει ότι υπάρχει ανεξάρτητα μετρημένη ακρίβεια για κάθε γλώσσα ή κοινότητα.
Μη θεωρείτε δεδομένο ότι το πρώτο ή το τελευταίο μέρος έχει πάντα τον ίδιο ρόλο. Το V2 επιλέγει τον διαθέσιμο υποψήφιο με το υψηλότερο αποθηκευμένο συνολικό πλήθος και δεν εγγυάται συγκεκριμένη θέση του μικρού ονόματος. Αρχικά γράμματα, σύντομα μέρη και αποθηκευμένες εγγραφές που λείπουν μπορεί να αφήσουν χωρίς απάντηση το αποτέλεσμα του συνόλου δεδομένων. Η εφεδρική χρήση AI μπορεί να ερμηνεύσει ολόκληρη την τιμή που στάλθηκε.
| Παράδειγμα εισόδου | Τι αντιπροσωπεύει | Τι να ελέγξετε |
|---|---|---|
प्रिया शर्मा | Πλήρες όνομα σε ντεβαναγκάρι | Περισσότερα μέρη μπορεί να γίνουν υποψήφιοι. Ελέγξτε το όνομα που επιλέχθηκε και την αντιστοίχιση αντί να υποθέσετε ότι επικρατεί το πρώτο μέρος. |
Priya Sharma | Παράδειγμα με λατινικούς χαρακτήρες | Είναι διαφορετική γραφή. Δεν είναι εγγυημένη πανομοιότυπη αντιστοίχιση ανάμεσα σε γραφές. |
A. Kumar | Αρχικό γράμμα και ένα ακόμη μέρος | Ένα αρχικό γράμμα δεν γίνεται υποψήφιος του συνόλου δεδομένων. Μια αντιστοίχιση στο άλλο μέρος δεν επιβεβαιώνει το αναμενόμενο μικρό όνομα. |
country: IN | Παράδειγμα πλαισίου: Ινδία | Χρησιμοποιήστε το όταν η εγγραφή σας έχει σχετικό πλαίσιο χώρας και όχι μόνο επειδή το όνομα εμφανίζεται σε αυτόν τον οδηγό. |
Συνειδητή επιλογή του πλαισίου χώρας IN
Η ζωντανή επίδειξη στέλνει country: IN (Ινδία). Το API δεν επιλέγει τη χώρα με βάση τη γραφή στην οποία είναι γραμμένο το όνομα. Στην ενσωμάτωσή σας χρησιμοποιήστε γνωστό και σχετικό πλαίσιο χώρας ή παραλείψτε το country. Μην κάνετε αυτή την τιμή του παραδείγματος προεπιλογή για όλες τις εγγραφές.
Για κάθε υποψήφιο, η αναζήτηση επιλέγει την εγγραφή της συγκεκριμένης χώρας, αν υπάρχει, και διαφορετικά εξετάζει τη γενική εγγραφή. Έπειτα επιλέγει τον διαθέσιμο υποψήφιο με το υψηλότερο αποθηκευμένο συνολικό πλήθος. Το πραγματικό εύρος της αντιστοίχισης αναφέρεται στα data.match.scope και data.match.country. Μια εγγραφή συγκεκριμένης χώρας με ισόπαλες συχνότητες δεν αντικαθίσταται αυτόματα από το γενικό αποτέλεσμα. Αν η εφεδρική χρήση είναι ενεργή, μπορεί να χρησιμοποιηθεί αντί γι' αυτό το AI.
Το data.input.country περιγράφει το πλαίσιο που στάλθηκε στο αίτημα. Τα data.country και data.country_source περιγράφουν τη συσχέτιση με χώρα που επιστράφηκε και την προέλευσή της. Είναι διαφορετικά πεδία και δεν δείχνουν ούτε την ιθαγένεια ούτε την εθνοτική καταγωγή ούτε τον τόπο διαμονής.
Αποστολή αιτήματος V2 για όνομα από την εφαρμογή σας
Ορίστε το GENDERAPI_API_KEY στο υπάρχον κλειδί σας και εκτελέστε το παράδειγμα στον διακομιστή σας. Το αίτημα ενεργοποιεί ρητά την κανονική εφεδρική χρήση AI. Δείχνει τη μορφή του αιτήματος και όχι μετρημένη ακρίβεια ή επιβεβαιωμένη κάλυψη. Για πρόβλεψη μόνο με το σύνολο δεδομένων, ορίστε options.ai_mode: off.
Επιλέξτε γλώσσα προγραμματισμού. Ρυθμίστε το κλειδί API σας, και έπειτα εκτελέστε το παράδειγμα στον διακομιστή σας.
Κάθε αίτημα πρόβλεψης είναι μια νέα χρεώσιμη λειτουργία, ακόμη και όταν πρόκειται για νέα προσπάθεια. Αυτά τα παραδείγματα δεν επαναλαμβάνουν αυτόματα το αίτημα. Ελέγξτε την κατάσταση χρέωσης πριν στείλετε άλλο αίτημα.
Πριν από την εκτέλεση: πρόσβαση και χειρισμός σφαλμάτων
Εκτελέστε αυτά τα παραδείγματα στον διακομιστή σας. Ορίστε στο περιβάλλον της διεργασίας το GENDERAPI_API_KEY με το υπάρχον κλειδί API σας. Ελέγξτε ότι το meta.access.mode έχει την τιμή api_key, επειδή ένα κλειδί που δεν αναγνωρίζεται μπορεί να οδηγήσει στη δοκιμαστική πρόσβαση IP.
Στις αποκρίσεις JSON με HTTP 4xx και 5xx διατηρείται το σώμα του σφάλματος και το παράδειγμα τερματίζει με μη μηδενικό κωδικό εξόδου. Ελέγξτε τα code, action και meta.usage.billing_status πριν δοκιμάσετε ξανά.
Οδηγός για σφάλματα και νέες προσπάθειες →cURL 7.76+ σε κέλυφος POSIX. Εκτελέστε το στο τερματικό. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Node.js 22+ με ενσωματωμένο fetch. Αποθηκεύστε ως example.mjs και εκτελέστε node example.mjs. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Python 3.10+ με την τυπική βιβλιοθήκη. Αποθηκεύστε ως example.py και εκτελέστε python3 example.py. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
PHP 8+ με την επέκταση cURL. Αποθηκεύστε ως example.php και εκτελέστε php example.php. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Java 17+ με τον τυπικό πελάτη HTTP. Αποθηκεύστε ως GenderApiExample.java και εκτελέστε java GenderApiExample.java. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Εφαρμογή κονσόλας .NET 8+. Χρησιμοποιήστε το ως Program.cs σε ένα έργο κονσόλας και έπειτα εκτελέστε dotnet run. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Go 1.22+ με την τυπική βιβλιοθήκη. Αποθηκεύστε ως main.go και εκτελέστε go run main.go. Τεκμηρίωση του περιβάλλοντος εκτέλεσης
Αποθήκευση του αποτελέσματος μαζί με τα τεκμήρια
Μια συσχέτιση που συνάγεται δεν είναι το φύλο που δηλώνει ένα άτομο. Αποθηκεύστε χωριστά την αρχική είσοδο, τα τεκμήρια που επιστράφηκαν και ό,τι έχει δηλώσει το ίδιο το άτομο. Ένα άγνωστο αποτέλεσμα είναι έγκυρο αποτέλεσμα και δεν πρέπει να γίνει μια μαντεμένη κατηγορία στην εφαρμογή σας.
| Πεδίο | Χρήση |
|---|---|
data.gender / data.result_status | Χρησιμοποιήστε male ή female μόνο μαζί με identified. Σε άγνωστο αποτέλεσμα διατηρήστε την εγγενή τιμή JSON null. |
data.name / data.match | Ελέγξτε το όνομα που επιστράφηκε και τον υποψήφιο που επιλέχθηκε. Μια αντιστοίχιση σε υποσυμβολοσειρά δεν αποδεικνύει ότι η είσοδος ανήκει σε άτομο με αυτό το όνομα. |
data.confidence / data.confidence_kind | Ο βαθμός βεβαιότητας εκφράζεται σε κλίμακα από 0 έως 1 ή είναι null. Το observed_frequency βασίζεται σε αποθηκευμένες συχνότητες, ενώ το model_reported είναι τιμή που αναφέρει το AI. Αξιολογήστε τα όρια χωριστά για κάθε τύπο. |
data.source / data.sample_count | Διακρίνετε τα dataset, ai και none. Τα αποτελέσματα του AI δεν έχουν αποθηκευμένο μέγεθος δείγματος. Ένα μέγεθος δείγματος δεν είναι μετρημένη ακρίβεια. |
meta.access.mode | Σε μια ενσωμάτωση με λογαριασμό ελέγξτε ότι επιστρέφεται api_key. Τα κλειδιά που λείπουν ή δεν αναγνωρίζονται μπορεί αντί γι' αυτό να χρησιμοποιήσουν την κοινόχρηστη δοκιμαστική πρόσβαση IP. |
meta.usage | Διαβάστε τα charged_credits και billing_status. Ένα επιτυχές άγνωστο αποτέλεσμα χρεώνεται. Μια απόκριση που χάθηκε δεν αποδεικνύει ότι το αίτημα ήταν δωρεάν. |
Πότε να χρησιμοποιείται AI
Το forceToGenderize είναι προαιρετικό για ονόματα, διευθύνσεις email και ονόματα χρήστη. Όταν είναι ενεργό, παραλείψτε το ai_mode ή χρησιμοποιήστε fallback. Τα off και always δεν συνδυάζονται με αυτή την επιλογή και επιστρέφουν 422. Ένα θετικό αρχικό υπόλοιπο αρκεί για να ξεκινήσει ένα αίτημα, ακόμη κι αν η τελική χρέωση κάνει το υπόλοιπο αρνητικό.
Η λειτουργία ψευδωνύμων μπορεί να επιστρέψει φύλο μαζί με name: null. Μπορεί επίσης να δώσει άγνωστο αποτέλεσμα. Ούτε η κανονική εφεδρική χρήση AI ούτε η ανάλυση ψευδωνύμων εγγυώνται σωστή απάντηση ή τιμή διαφορετική από null.
| Επιλογή αιτήματος | Συμπεριφορά | Πιστώσεις για επιτυχή αναζήτηση |
|---|---|---|
| options.ai_mode: off | Χρησιμοποιεί μόνο το σύνολο δεδομένων. | 1, και για άγνωστο αποτέλεσμα |
| options.ai_mode: fallback | Ελέγχει πρώτα το σύνολο δεδομένων και έπειτα χρησιμοποιεί κανονικό AI, αν δεν επιστραφεί φύλο. Είναι η προεπιλογή για τα μεμονωμένα αιτήματα. | 1 συνολικά, μαζί με την εφεδρική χρήση AI |
| options.ai_mode: always | Χρησιμοποιεί απευθείας AI. | 2 |
| forceToGenderize: true | Ελέγχει πρώτα το σύνολο δεδομένων και έπειτα αφήνει το AI να ερμηνεύσει ένα προσωπικό ψευδώνυμο ή ένα alias, ακόμη και χωρίς πραγματικό μικρό όνομα. | 1 για αποτέλεσμα από το σύνολο δεδομένων, 2 συνολικά αν χρησιμοποιηθεί AI |
Επεξεργασία μιας λίστας ονομάτων χωρίς απώλεια του πλαισίου
Στείλτε έως 50 στοιχεία με κλειδί API ή έως 10 με τη δοκιμαστική πρόσβαση IP μέσω POST /api/v2/gender/batch. Δώστε σε κάθε στοιχείο ένα μοναδικό id και διατηρήστε την αρχική τιμή κάθε γραμμής. Κάθε στοιχείο μπορεί να έχει τις δικές του επιλογές για χώρα και AI. Παραλείψτε τη χώρα όταν δεν είναι γνωστή.
Σε αντίθεση με τα μεμονωμένα αιτήματα, που χρησιμοποιούν από προεπιλογή την εφεδρική χρήση, τα στοιχεία μιας παρτίδας χρησιμοποιούν από προεπιλογή μόνο το σύνολο δεδομένων. Ορίστε options.ai_mode: fallback σε κάθε στοιχείο που χρειάζεται AI. Ελέγξτε κάθε αποτέλεσμα, ακόμη και μετά από HTTP 200, διατηρήστε τα άγνωστα αποτελέσματα και ελέγξτε τα σφάλματα και τη χρέωση πριν από νέα αποστολή. Κάθε κανονικό επιτυχές στοιχείο κοστίζει 1 πίστωση. Ένα αίτημα HTTP για παρτίδα δεν αντιστοιχεί σε μία πίστωση ανά πρόβλεψη.
Να γνωρίζετε τι στέλνετε
Η ζωντανή επίδειξη στέλνει την τιμή που εισάγετε στο GenderAPI.io μόνο όταν την υποβάλετε εσείς. Αν χρησιμοποιηθεί AI, τα type, value και το πλαίσιο χώρας που στάλθηκαν διαβιβάζονται στη ρυθμισμένη υπηρεσία προβλέψεων. Για πρόβλεψη μόνο με το σύνολο δεδομένων, ορίστε στην ενσωμάτωσή σας options.ai_mode: off χωρίς forceToGenderize.
Η πολιτική απορρήτου, η σύμβαση επεξεργασίας δεδομένων και ο κατάλογος των υπεργολάβων επεξεργασίας περιγράφουν τους δημοσιευμένους όρους επεξεργασίας. Ένα αποτέλεσμα είναι μια συσχέτιση που συνάγεται και ό,τι δηλώνει ένα άτομο έχει προτεραιότητα. Μην το χρησιμοποιείτε ως βάση για αποφάσεις με σημαντικές συνέπειες για ένα άτομο.
Συχνές ερωτήσεις
Δέχεται η επίδειξη για ινδικά ονόματα μόνο ονόματα στα χίντι;
Η επίδειξη χρησιμοποιεί ένα παράδειγμα σε ντεβαναγκάρι, αλλά το API δέχεται ονόματα ως συμβολοσειρές Unicode. Αυτή η δυνατότητα δεν σημαίνει ούτε πλήρη κάλυψη του συνόλου δεδομένων ούτε μετρημένη ακρίβεια για κάθε γλώσσα που χρησιμοποιείται στην Ινδία.
Επιστρέφει η λατινική γραφή το ίδιο αποτέλεσμα με την αρχική γραφή;
Δεν είναι εγγυημένο. Η τρέχουσα αναζήτηση δεν προβλέπει γενική αντιστοιχία μεταξύ μεταγραφών. Διατηρήστε κάθε γραφή που στάλθηκε μαζί με τις πληροφορίες source, match και confidence που επιστράφηκαν.
Έχει δημοσιευθεί ανεξάρτητη αξιολόγηση της ακρίβειας για αυτή την ομάδα ονομάτων;
Αυτή η σελίδα δεν δημοσιεύει τέτοια αξιολόγηση. Η αποδοχή της εισόδου, η εμφάνιση αποθηκευμένων συχνοτήτων ή η επιστροφή ενός βαθμού βεβαιότητας δεν αποτελούν ανεξάρτητη μέτρηση της ακρίβειας. Η μεθοδολογία περιγράφει ποια δεδομένα είναι διαθέσιμα και ποιες μετρήσεις δεν έχουν δημοσιευθεί ακόμη.
Καταναλώνει πιστώσεις ένα αποτέλεσμα χωρίς πρόβλεψη;
Ένα επιτυχές άγνωστο αποτέλεσμα χρεώνεται. Η κανονική λειτουργία με το σύνολο δεδομένων ή με την εφεδρική χρήση κοστίζει 1 πίστωση συνολικά. Με το forceToGenderize το αίτημα κοστίζει 1 πίστωση αν το αποτέλεσμα προέρχεται από το σύνολο δεδομένων ή 2 συνολικά αν χρησιμοποιηθεί AI, ακόμη και για άγνωστο αποτέλεσμα. Για τα σφάλματα ισχύουν χωριστοί κανόνες χρέωσης. Ελέγξτε το meta.usage.