Skeln mellem Unicode-input og opdeling af fulde navne
Du kan sende et kinesisk navn som Unicode-tekst uden først at omskrive det til latinsk skrift. Det nuværende opslag kontrollerer normaliserede dele; et fuldt kinesisk navn uden mellemrum bliver ikke automatisk delt op i efternavn og fornavn. 王静怡 er altså én kandidat og ikke et garanteret opslag på 静怡.
For de almindelige kinesiske tegn i eksemplerne springer datasættets nuværende kandidatfilter dele med ét eller to tegn over. Et kort fornavn kan være gyldigt input og alligevel ikke give nogen kandidat. Den almindelige automatiske AI-fallback kan stadig fortolke den oprindeligt sendte værdi; en forespørgsel, der kun bruger datasættet, lader resultatet forblive ukendt.
Unicode-normaliseringen NFKC giver ingen generel omsætning mellem forenklet og traditionelt kinesisk og fører ikke en latinsk stavemåde tilbage til ét oprindeligt kinesisk navn. Bevar den sendte stavemåde, og kontrollér det returnerede match. Efternavnets placering, skriften eller romaniseringen er ikke nok til at drage konklusioner om en persons køn eller land.
| Eksempel på input | Hvad det viser | Hvad du kontrollerer |
|---|---|---|
王静怡 | Fuldt navn uden mellemrum | Én kandidat i datasættet. Den nuværende analyse skiller ikke efternavnet fra. |
静怡 | Fornavn med to tegn | Springes over på grund af kandidatfiltrets længdegrænse; AI-fallback kan fortolke den oprindelige værdi. |
王 静怡 | Separate korte dele | Et ekstra mellemrum omgår ikke længdegrænsen. Begge dele i eksemplet er for korte til opslaget i datasættet. |
Wang Jingyi | Input med latinsk skrift | Behandles som en separat værdi og deles op i sine egne dele. Det er ikke garanteret, at den føres tilbage til de oprindelige tegn eller den samme post. |
Vælg landekonteksten CN bevidst
Live-demoen sender country: CN (Kina). API'et vælger ikke dette land ud fra den skrift, navnet er skrevet med. Brug en kendt, relevant landekontekst i din integration, eller udelad country. Gør ikke denne eksempelværdi til en standard for alle poster.
For hver kandidat vælger opslaget den landespecifikke post, hvis den findes, og ellers den globale post. Derefter vælges den tilgængelige kandidat med det højeste lagrede samlede antal. Matchets faktiske omfang fremgår af data.match.scope og data.match.country. En landespecifik post med lige store frekvenser erstattes ikke automatisk af det globale resultat; hvis fallback er slået til, kan AI bruges i stedet.
data.input.country beskriver den landekontekst, der blev sendt i forespørgslen. data.country og data.country_source beskriver den returnerede tilknytning til et land og dens oprindelse. Det er forskellige felter, og de siger intet om nationalitet, etnisk oprindelse eller bopæl.
Send en V2-forespørgsel med et navn fra din applikation
Angiv din eksisterende nøgle i GENDERAPI_API_KEY, og kør eksemplet på din server. Forespørgslen slår den almindelige automatiske AI-fallback eksplicit til. Den viser, hvordan forespørgslen er opbygget, ikke en målt nøjagtighed eller en bekræftet dækning. Angiv options.ai_mode: off, hvis du vil have en forudsigelse, der kun bruger datasættet.
Vælg et programmeringssprog. Konfigurér din API-nøgle, og kør derefter eksemplet på din server.
Hver forespørgsel om en forudsigelse er en ny operation, der koster kreditter, også når den gentages. Eksemplerne prøver ikke automatisk igen. Kontrollér opkrævningsstatus, før du sender en ny forespørgsel.
Før du kører: adgang og fejlhåndtering
Kør eksemplerne på din server. Sæt GENDERAPI_API_KEY i procesmiljøet til din eksisterende API-nøgle. Bekræft, at meta.access.mode er api_key: En nøgle, der ikke genkendes, kan føre til IP-prøveadgangen.
JSON-svar med HTTP 4xx og 5xx bevarer fejlens body og returnerer en exitstatus, der ikke er nul. Kontrollér code, action og meta.usage.billing_status, før du prøver igen.
Guide til fejl og nye forsøg →cURL 7.76+ i en POSIX-shell. Kør i din terminal. Dokumentation for kørselsmiljøet
Node.js 22+, indbygget fetch. Gem som example.mjs, og kør node example.mjs. Dokumentation for kørselsmiljøet
Python 3.10+, standardbiblioteket. Gem som example.py, og kør python3 example.py. Dokumentation for kørselsmiljøet
PHP 8+ med cURL-udvidelsen. Gem som example.php, og kør php example.php. Dokumentation for kørselsmiljøet
Java 17+, standard-HTTP-klienten. Gem som GenderApiExample.java, og kør java GenderApiExample.java. Dokumentation for kørselsmiljøet
Konsolapplikation med .NET 8+. Brug som Program.cs i et konsolprojekt, og kør derefter dotnet run. Dokumentation for kørselsmiljøet
Go 1.22+, standardbiblioteket. Gem som main.go, og kør go run main.go. Dokumentation for kørselsmiljøet
Gem resultatet sammen med evidensen
En udledt sammenhæng er ikke det køn, en person selv har oplyst. Gem det oprindelige input, den returnerede evidens og det, personen selv har oplyst, hver for sig. Et ukendt resultat er et gyldigt resultat og bør ikke blive til en gættet kategori i din applikation.
| Felt | Sådan bruger du det |
|---|---|
data.gender / data.result_status | Brug kun male eller female, når status er identified. Bevar den native JSON-værdi null, når resultatet er ukendt. |
data.name / data.match | Kontrollér det returnerede navn og den valgte kandidat. Et match på en delstreng beviser ikke, at inputtet tilhører en person med det navn. |
data.confidence / data.confidence_kind | Konfidensen ligger på en skala fra 0 til 1 eller er null. observed_frequency bygger på lagrede frekvenser, mens model_reported er en værdi angivet af AI. Vurdér tærskelværdier separat for hver type. |
data.source / data.sample_count | Skeln mellem dataset, ai og none. AI-resultater har ingen lagret stikprøvestørrelse. En stikprøvestørrelse er ikke en målt nøjagtighed. |
meta.access.mode | Kontrollér i en integration med konto, at api_key returneres. Manglende eller ukendte nøgler kan i stedet bruge den delte IP-prøveadgang. |
meta.usage | Læs charged_credits og billing_status. Et gennemført ukendt resultat koster kreditter. Et mistet svar beviser ikke, at forespørgslen var gratis. |
Beslut, hvornår AI skal bruges
forceToGenderize er valgfrit for navne, e-mailadresser og brugernavne. Når det er slået til, skal du udelade ai_mode eller bruge fallback. off og always kan ikke kombineres med denne indstilling og returnerer 422. En positiv startsaldo er nok til at starte en forespørgsel, også selvom den endelige opkrævning gør saldoen negativ.
Kaldenavnstilstanden kan returnere et køn sammen med name: null. Den kan også give et ukendt resultat. Hverken den almindelige automatiske AI-fallback eller fortolkningen af kaldenavne garanterer et korrekt svar eller en værdi, der ikke er null.
| Indstilling i forespørgslen | Adfærd | Kreditter for en gennemført forespørgsel |
|---|---|---|
| options.ai_mode: off | Bruger kun datasættet. | 1, også for et ukendt resultat |
| options.ai_mode: fallback | Slår først op i datasættet og bruger derefter almindelig AI, hvis der ikke returneres et køn. Det er standarden for enkeltforespørgsler. | 1 i alt, inklusive automatisk AI-fallback |
| options.ai_mode: always | Bruger AI direkte. | 2 |
| forceToGenderize: true | Slår først op i datasættet og lader derefter AI fortolke et personligt kaldenavn eller alias, også uden et egentligt fornavn. | 1 for et resultat fra datasættet, 2 i alt, hvis AI bruges |
Behandl en liste med navne uden at miste konteksten
Send op til 50 elementer med en API-nøgle eller 10 med IP-prøveadgangen via POST /api/v2/gender/batch. Giv hvert element et unikt id, og bevar den oprindelige værdi for hver række. Hvert element kan have sine egne indstillinger for land og AI; udelad landet, hvis det ikke er kendt.
I modsætning til enkeltforespørgsler, der som standard bruger fallback, bruger elementer i en batch som standard kun datasættet. Angiv options.ai_mode: fallback for hvert element, der har brug for AI. Kontrollér hvert resultat, også efter HTTP 200, gem ukendte resultater, og kontrollér fejl og opkrævning, før du sender igen. Hvert gennemført almindeligt element koster 1 kredit; én HTTP-forespørgsel med en batch svarer ikke til én kredit pr. forudsigelse.
Vid, hvad du sender
Live-demoen sender kun den indtastede værdi til GenderAPI.io, når du selv sender den. Hvis AI bruges, videregives type, value og den sendte landekontekst til den tjeneste, der er konfigureret til forudsigelser. Hvis du kun vil have en forudsigelse fra datasættet, skal du i din integration angive options.ai_mode: off uden forceToGenderize.
Privatlivspolitikken, databehandleraftalen og listen over underdatabehandlere beskriver de offentliggjorte vilkår for behandlingen. Et resultat er en udledt sammenhæng, og det, en person selv oplyser, har forrang. Brug det ikke som grundlag for beslutninger, der har betydelige konsekvenser for en person.
Ofte stillede spørgsmål
Hvorfor kan et kinesisk fornavn med to tegn forblive ukendt, når kun datasættet bruges?
Det nuværende kandidatfilter springer dele over, hvis længde som JavaScript-tegnstreng højst er to. For de kinesiske tegn, der vises her, er et fornavn med to tegn gyldigt input, men det bliver ikke en kandidat i datasættet. AI-fallback kan fortolke den oprindelige værdi.
Skiller V2 automatisk det kinesiske efternavn fra fornavnet?
Opslaget i datasættet deler ikke et fuldt kinesisk navn uden mellemrum op. AI kan udlede et fornavn fra hele værdien, men ingen af vejene garanterer, at det tilsigtede fornavn vælges. Kontrollér source og match i svaret.
Er der offentliggjort en uafhængig evaluering af nøjagtigheden for denne gruppe navne?
Denne side offentliggør ikke en sådan evaluering. At input accepteres, at lagrede frekvenser vises, eller at der returneres en konfidensværdi, er ikke en uafhængig måling af nøjagtigheden. Metodebeskrivelsen forklarer, hvilke data der er tilgængelige, og hvilke målinger der endnu ikke er offentliggjort.
Koster et resultat uden forudsigelse kreditter?
Et gennemført ukendt resultat opkræves. Den almindelige tilstand med datasættet eller med fallback koster 1 kredit i alt. Med forceToGenderize koster forespørgslen 1 kredit, hvis resultatet kommer fra datasættet, eller 2 i alt, hvis AI bruges, også ved et ukendt resultat. Fejl følger separate opkrævningsregler; kontrollér meta.usage.