Eksempler på inndata
Et kallenavn er ingen bekreftelse av identitet
@alice_smith kan gi treff på et navneelement. For prenses med forceToGenderize kan et estimat returneres selv om navnet forblir null. user47291 kan forbli ukjent. Dette er bare eksempler på inndata; de har ikke noe forhåndsbestemt kjønnsresultat.
Analyselogikk
Hvordan fungerer kjønnsestimering ut fra brukernavn?
Systemet ser etter gjenkjennelige navneelementer og andre språklige holdepunkter i brukernavnet eller visningsnavnet. Vanlig KI-reserve ser etter et brukbart ekte fornavn; med forceToGenderize kan KI tolke et kallenavn uten et ekte fornavn. Resultatet returneres sammen med kontekstfeltene. Ikke tving frem et resultat for tilfeldige eller utilstrekkelige inndata.
Bruksmåter
Velg metoden som passer dataene dine
Behandle store datasett uten kode
Analyser brukernavn i Excel eller CSV i fire trinn
- 01
Åpne Excel/CSV-verktøyet
Åpne filverktøyet til GenderAPI, og last opp filen som skal behandles.
- 02
Velg kildekolonnen
Tilordne kolonnen som inneholder brukernavn, kallenavn eller visningsnavn.
- 03
Slå på tolkning av kallenavn
Aktiver alternativet som tolker aliaser og navn fra sosiale medier.
- 04
Kontroller et utvalg, og eksporter deretter
Gå først gjennom et representativt utvalg av poster, behandle deretter hele filen, og last ned de berikede dataene.
Nye kontoer får 200 gratis kreditter per dag, så du kan teste arbeidsflyten på et utvalg før du behandler hele filen.
Bruksområder
Bruk det som et supplerende signal når et ekte fornavn mangler
Når navnefeltet er tomt, kan analyse av brukernavn være nyttig for data fra sosiale medier, fellesskap, spill og profiler som brukerne selv har opprettet. Hvis du har en mer direkte og pålitelig kilde, for eksempel et ekte fornavn eller en e-postadresse, bruker du det tilsvarende endepunktet.
Begrensninger
Ikke behandle resultatet som en bekreftet identitet
Ikke alle kallenavn inneholder et ekte fornavn, kulturelle assosiasjoner varierer, og samme uttrykk kan ha ulik betydning på forskjellige språk. Når signalet ikke er tilstrekkelig, bør du godta et tomt resultat i stedet for å trekke en sikker konklusjon av svake data.
Implementeringsveiledning for V2
Lagre kildedata og estimat hver for seg
Behold den opprinnelige identifikatoren for posten. API-et åpner ingen profil, kontrollerer ikke hvem som eier en konto, og bekrefter ingen identitet. Send bare landkontekst når du har pålitelig informasjon, og ikke utled den fra domenet eller språket på nettstedet.
| Eksempel på inndata | Felt eller alternativ | Tolkning |
|---|---|---|
| @alice_smith | data.name / data.match | Behold det opprinnelige brukernavnet, og ikke behandle den gjenkjente delen som et verifisert navn. |
| prenses | forceToGenderize: true | Gjør det mulig å tolke et kallenavn uten et ekte fornavn. Et kjønn kan returneres mens data.name er null; ikke dikt opp et navn for personen. |
| user47291 | data.result_status: unknown | Tvetydige eller utilstrekkelige inndata kan forbli ukjente. Det er ingen grunn til å sende forespørselen automatisk på nytt. |
Send brukernavnet med type: username, ikke en profil-URL. Oppslaget i datasettet fjerner en innledende @, normaliserer teksten og lager kandidater ut fra skilletegn og sifre. En standardforespørsel kan legge til et begrenset antall treff fra begynnelsen og slutten; forceToGenderize bruker ikke disse ekstra delene. Hvis flere rader gir treff, velges raden med flest registrerte forekomster. Bruk type: email for e-postadresser og type: name for ekte navn.
Velg behandlingsmodus og kostnad i kreditter
| Alternativ | Behandling | Kreditter per fullført element |
|---|---|---|
| options.ai_mode: off | Bare datasettet | 1 kreditt |
| options.ai_mode: fallback | Først datasettet; vanlig KI-reserve hvis kjønnet ikke kan bestemmes | 1 kreditt totalt, inkludert KI |
| options.ai_mode: always | Direkte til KI | 2 kreditter |
| forceToGenderize: true | Først datasettet, deretter tolkning av kallenavnet uten krav om et ekte fornavn | 1 hvis datasettet er nok, 2 totalt hvis KI brukes |
Standard for en enkeltforespørsel er fallback, og for elementer i en samleforespørsel er det off. forceToGenderize er valgfritt for navn, e-postadresser og brukernavn; utelat da ai_mode eller bruk fallback, fordi alternativet ikke kan kombineres med off og always. Fullførte unknown-resultater belastes også. En positiv saldo er nok til å starte, og etter at behandlingen er fullført, kan saldoen bli negativ.
Gi hvert element i en samleforespørsel egne alternativer
Eksempler på inndata garanterer ikke et bestemt estimat. Sett GENDERAPI_API_KEY i servermiljøet, og ikke legg nøkkelen i offentlig kode på klientsiden. V1 og V2 bruker samme API-nøkkel og samme kontosaldo. Kontroller nøkkelen med /api/v2/usage, og bekreft at meta.access.mode har verdien api_key.
Velg et programmeringsspråk. Konfigurer API-nøkkelen, og kjør deretter eksemplet på serveren din.
Hver prediksjonsforespørsel er en ny operasjon som belastes, også nye forsøk. Disse eksemplene prøver ikke automatisk på nytt. Sjekk belastningsstatusen før du sender en ny forespørsel.
Før du kjører: tilgang og feilhåndtering
Kjør disse eksemplene på serveren din. Sett GENDERAPI_API_KEY i prosessmiljøet til din eksisterende API-nøkkel. Bekreft at meta.access.mode er api_key: en nøkkel som ikke gjenkjennes, kan føre til IP-prøveperioden.
Ved JSON-svar med HTTP 4xx og 5xx beholdes feilinnholdet, og eksemplet avsluttes med en exit-status som ikke er null. Sjekk code, action og meta.usage.billing_status før du prøver på nytt. Ved HTTP 200-svar på samleforespørsler må du også kontrollere data eller error for hvert element.
Veiledning om feil og nye forsøk →cURL 7.76+ i et POSIX-skall. Kjør i terminalen. Dokumentasjon for kjøretidsmiljøet
Node.js 22+; innebygd fetch. Lagre som example.mjs og kjør node example.mjs. Dokumentasjon for kjøretidsmiljøet
Python 3.10+; standardbiblioteket. Lagre som example.py og kjør python3 example.py. Dokumentasjon for kjøretidsmiljøet
PHP 8+ med cURL-utvidelsen. Lagre som example.php og kjør php example.php. Dokumentasjon for kjøretidsmiljøet
Java 17+; standard HTTP-klient. Lagre som GenderApiExample.java og kjør java GenderApiExample.java. Dokumentasjon for kjøretidsmiljøet
Konsollapplikasjon i .NET 8+. Bruk som Program.cs i et konsollprosjekt, og kjør deretter dotnet run. Dokumentasjon for kjøretidsmiljøet
Go 1.22+; standardbiblioteket. Lagre som main.go og kjør go run main.go. Dokumentasjon for kjøretidsmiljøet
Håndter resultater fra lister og nye forsøk
POST /api/v2/gender/batch godtar opptil 50 elementer med en API-nøkkel og 10 i IP-prøveperioden. Gi hvert element egne verdier for type, value og options. Hvis du vil bruke vanlig KI-reserve, må du angi fallback uttrykkelig i hvert element. id må være unik i samleforespørselen, og index begynner på null i den innsendte samleforespørselen. Lagre dine egne jobb- og kilderad-ID-er separat.
HTTP 200 betyr ikke at alle elementer er fullført. Håndter resultatene identified, unknown og error hver for seg; meta.summary.succeeded teller både identified og unknown. Vurder data.gender, source, confidence_kind, confidence, match og reason samlet, og ikke behandle en KI-verdi og en frekvens i datasettet som det samme.
Hvis meta.usage.billing_status har verdien confirmed, skal du bare gjenta feilene som tillater et nytt forsøk. Hvis statusen er unconfirmed, eller svaret har gått tapt, må du stoppe og kontrollere belastningen. Hvis du sender det samme elementet på nytt, også et fullført unknown-resultat, belastes det som en ny handling; send aldri hele listen på nytt uten kontroll.
Regler for samleforespørsler · Svarfelt · KI-alternativer · Vurdering av nøyaktighet og konfidens · Personvernerklæring
Tilleggene for Excel og Google Sheets og de andre ferdige integrasjonene kan bruke egen tilkobling og eget resultatformat. Ikke gå ut fra at utdataene deres følger dette V2-JSON-skjemaet; les den gjeldende veiledningen for den aktuelle integrasjonen.
Vanlige spørsmål
Kjønn fra brukernavn og kallenavn
Kan kjønn estimeres ut fra et brukernavn?
Når forceToGenderize er slått på i V2, kontrolleres datasettet først. Hvis kjønnet ikke kan bestemmes, kan KI tolke kallenavnet uten at det kreves et ekte fornavn. Resultatet kan fortsatt være unknown og er ikke en bekreftet identitet. Vanlig KI-reserve krever derimot et brukbart ekte fornavn.
Hvilke brukernavn gir de mest nyttige resultatene?
Verdier som inneholder et ekte fornavn, en vanlig form av et kallenavn eller et tydelig navneelement, gir oftere et nyttig signal. Tilfeldige tegnstrenger og merkenavn gir ikke alltid et resultat.
Kan jeg analysere ett brukernavn via API-et?
Ja. Endepunktet for enkeltforespørsler analyserer én verdi, og et eget endepunkt for samleforespørsler håndterer flere elementer.
Kan jeg laste opp en Excel- eller CSV-fil?
Ja. Velg kolonnen med brukernavn eller visningsnavn i filverktøyet, og slå på tolkning av kallenavn.
Hvorfor bør konfidensfeltet og kildefeltet fra V2 lagres sammen?
I V2 ligger data.confidence mellom 0 og 1. En KI-verdi og en frekvens i datasettet måler ulike ting, så les verdien sammen med source og confidence_kind. Behold også unknown-resultatene og feltet reason.
Kan resultatet brukes til kundesegmentering?
Det kan være et supplerende signal i aggregerte analyser eller ved databerikelse, men bør ikke alene avgjøre spørsmål med stor betydning for en person eller brukes til å fastslå noens identitet.
Kan jeg teste gratis?
Nye GenderAPI-kontoer får 200 gratis kreditter per dag, som kan brukes til å teste et representativt utvalg via API-et eller filverktøyet.
