Hva betyr source i V2?
Feltet source viser hvilken vei som ga det endelige resultatet: et oppslag i det lagrede datasettet, en prediksjon fra KI eller ingen valgt kilde. Det er ikke en henvisning til den opprinnelige utgiveren av et datasett, ikke et lisensbevis og ikke en garanti for at prediksjonen er riktig.
Denne veiledningen beskriver den nåværende svarkontrakten i V2 og en databaseprofil som GenderAPI.io selv har laget. Observasjonene nedenfor er målte opptellinger og konsistenskontroller; en gjennomgått katalog over de opprinnelige kildene og en uavhengig måling av nøyaktigheten er fortsatt ikke publisert.
| source | Hva det forteller deg | Hva det ikke fastslår |
|---|---|---|
dataset | En lagret rad ble valgt; ved nøyaktig likt antall kan kjønnet likevel være ukjent | Den opprinnelige utgiveren, innsamlingsmetoden, lisensen, alderen på raden eller om observasjonene er uavhengige |
ai | Det endelige svaret kom fra den konfigurerte prediksjonsveien med KI; gender kan likevel være null | Et opptalt utvalg, en henvisning til et datasett eller en kalibrert nøyaktighet for prediksjonen |
none | Ingen lagret rad ble valgt for det endelige utfallet i modusen med bare datasettet | At inndataene ikke har noen mulig tilknytning til et navn i noen populasjon eller på noe språk |
Databaseprofil: 26. september 2026
Metadataene for samlingene ble lest 2026-09-26T15:28:18.227Z, og de tilfeldige utvalgene ble lest 2026-09-26T15:31:54.045Z. Begge antallene kommer fra metadataene i MongoDB collStats for hver samling, ikke fra en egen fullstendig opptelling. Den generelle samlingen inneholder lagrede navnerader, og den landspesifikke samlingen inneholder lagrede rader for navn og land. Antallene må ikke legges sammen til et totalt antall unike navn eller unike personer.
For hver samling trakk MongoDB tilfeldig ut 5 000 dokumenter og beregnet de aggregerte kontrollene nedenfor på databaseserveren. Den offentlige rapporten inneholder ingen navn eller rådata. Dette er observasjoner som GenderAPI.io selv har gjort i en database i drift, ikke en uavhengig revisjon og ikke et fastfrosset evalueringsdatasett. Kontrollene gjelder konsistensen i antallene, ikke nøyaktigheten til prediksjonene, antallet unike personer eller navn eller dekningen til API-et.
| Observasjon | Generelle rader | Landspesifikke rader |
|---|---|---|
| Samling | general | country-specific |
| Antall dokumenter ifølge metadataene | 2 483 220 | 4 080 692 |
| Lagret unik nøkkel | name | name + country |
| Tilfeldig utvalgte dokumenter | 5 000 | 5 000 |
| Brudd på de numeriske reglene i utvalget | 0 | 0 |
| male + female avviker fra total i utvalget | 0 | 0 |
| Likt antall for male og female i utvalget | 124 | 94 |
| Feltet updated_at finnes i utvalget | 667 / 5 000 | 741 / 5 000 |
Hva databasekontrollene fastslår
Den numeriske kontrollen krever at total er et positivt, sikkert heltall, og at antallene for male og female er endelige og ligger mellom 0 og total. En egen kontroll sammenligner male + female med total. Alle tellerne i utvalgene besto disse kontrollene; det er ingen påstand om at hver rad i samlingene er konsistent, eller at en prediksjon er riktig.
Likt antall for male og female forekom i 124 rader i utvalget fra den generelle samlingen og i 94 rader i utvalget fra den landspesifikke samlingen. Dette er likhet i lagrede antall, ikke uavhengig bekreftede tvetydige identiteter og ikke en andel ukjente resultater fra API-et. De faktiske resultatene fra API-et avhenger av inndataene, tilgjengeligheten til Redis, valget av kandidater og KI-innstillingene.
En egen opptelling av feltet country i den generelle samlingen, gjort 2026-09-26T15:33:13.811Z, fant 244 ulike lagrede verdier: 239 hadde formatet med to store bokstaver, og 5 hadde det ikke. Om verdiene er gyldige ISO-koder, fordelingen av landspesifikke rader og dekningen av land som støttes, er ikke målt. Disse tallene er ikke antallet land som støttes.
Ingen felt for kilde eller lisens fantes i de to utvalgene. Det fastslår ikke at opplysninger om opprinnelse mangler i hver rad eller i eksterne systemer. updated_at fantes som et numerisk felt i noen rader, men verdiene og betydningen ble ikke undersøkt; det fastslår ikke hvor oppdaterte dataene er, eller en plan for oppdateringer.
V2 utfører oppslag i datasettet via Redis. 26. september 2026 bekreftet GenderAPI.io, som administrator av systemet, at MongoDB og Redis inneholder det samme datasettet. Likheten bygger på denne bekreftelsen: Det er ikke gjort en uavhengig sammenligning av de to databasene, og en slik kontroll gjenstår. Opptellingen ovenfor beskriver lagrede rader; svardekningen til API-et avhenger også av inndataene som sendes, treffet på kandidater og KI-innstillingene. Utvalgene ble trukket uten fast startverdi, lest uten et fastfrosset øyeblikksbilde og hadde ingen uavhengige referanseetiketter; de kan ikke måle nøyaktigheten til prediksjonene, kalibreringen eller svardekningen.
Følg grunnlaget i svaret
| Felt | Betydning | Begrensning |
|---|---|---|
input | Gjentar inndatatypen, verdien og landkonteksten som ble sendt | En inndataverdi er ikke uavhengig bekreftet informasjon om en identitet |
match.name / match.method | Viser den valgte kandidaten og om den ble normalisert, delt opp i navnedeler, hentet ut som en delstreng eller utledet av en modell | Et treff på en navnedel garanterer ikke at et ekte fornavn ble skilt ut fra et fullt navn eller et brukernavn |
match.scope / match.country | Viser om den valgte lagrede raden kom fra det landspesifikke eller det globale oppslaget | Et oppgitt land garanterer ikke at det fantes en landrad |
sample_count | Totalen som er lagret i den valgte raden; null ved en prediksjon fra KI | Ikke nødvendigvis unike personer, uavhengig innsamlede observasjoner eller størrelsen på en nøyaktighetsevaluering |
confidence / confidence_kind | Skiller et forholdstall fra lagrede antall fra en verdi rapportert av modellen | Ingen av verdiene er en bekreftet sannsynlighet for en persons kjønnsidentitet |
country / country_source | Landmetadata for den returnerte raden eller en tilknytning mellom navnet og et land fra KI, når dette finnes | Ikke nasjonalitet, bosted eller en bekreftet opprinnelse, og ikke et bevis på at landet i forespørselen ga treff |
Hvordan treff på inndataene påvirker et resultat
Oppslaget i datasettet normaliserer teksten og utleder kandidater i form av navnedeler. For e-postadresser utledes kandidatene fra den lokale delen; for brukernavn fjernes en valgfri @ i starten. Vanlige oppslag for e-postadresser og brukernavn kan også prøve avgrensede delstrenger som kandidater. Hvis flere kandidatrader er tilgjengelige, velges raden med det høyeste lagrede totalantallet. Det kan bli en annen navnedel enn det tiltenkte fornavnet.
Når en landkontekst er oppgitt, prøver oppslaget landraden for hver kandidat og bruker den globale raden når landraden mangler. Det endelige resultatet viser treffet som ble valgt. En tvetydig landrad erstattes ikke automatisk av den globale raden for den samme kandidaten.
Den vanlige ledeteksten til KI ber om et gjenkjennelig fornavn. forceToGenderize tillater i tillegg tilknytninger via personlige kallenavn eller alias, så et kjønn som ikke er null, sammen med name: null er gyldig i denne modusen. Dette er ulike prediksjonsoppgaver som må evalueres hver for seg.
Oppslag i datasettet og behandling med KI
Når KI brukes, sender V2 type, value og landkonteksten som ble sendt, til tjenesten som er konfigurert for prediksjoner med KI. For e-postadresser ber ledeteksten modellen om å se bort fra domenet og suffikset etter plusstegnet; det er ikke et løfte om at disse tegnene fjernes fra verdien før KI behandler den. Bruk ai_mode: off uten forceToGenderize når arbeidsflyten din krever prediksjoner som bare bruker datasettet.
Valideringen av KI-svaret kontrollerer JSON-feltene, typene og konsistensen mellom feltene. Den beviser ikke at et returnert navn, en tilknytning til et kjønn eller en tilknytning til et land er riktig. Det offentlige resultatet inneholder ikke modellens navn, modellversjonen eller en kilde for prediksjonen.
| Alternativ | Prediksjonsvei | Grunnlag som returneres |
|---|---|---|
| ai_mode: off | Bruker bare oppslag i datasettet | Metadata for den valgte raden i datasettet eller et ukjent resultat uten valgt rad |
| ai_mode: fallback | Prøver datasettet først; bruker KI hvis det ikke returneres et kjønn | Grunnlaget for den endelige veien, ikke et samlet utvalg fra datasettet og KI |
| ai_mode: always | Bruker den konfigurerte prediksjonsveien med KI direkte | En verdi rapportert av modellen eller et ukjent resultat med confidence null; sample_count er alltid null |
| forceToGenderize: true | Prøver datasettet og deretter KI med tolkning av kallenavn hvis det ikke finnes et resultat | Grunnlag fra datasettet eller en tilknytning via et alias rapportert av modellen; name kan være null |
Kildedokumentasjon som ennå ikke er publisert
En gjennomgått kildekatalog er ikke publisert her. Svarkontrakten og implementeringens virkemåte alene kan ikke bekrefte hvor dataene kommer fra, retten til å bruke en kilde, hvor representativ den er, eller kvaliteten på etikettene. Før det fremsettes påstander om bestemte kilder, må følgende grunnlag dokumenteres og gjennomgås.
Denne gjennomgangen av dokumentasjonen fastslår ikke om de opprinnelige kildene er lisensiert eller ikke, eller om de er fullstendige eller ufullstendige. Den beskriver begrensningene i det offentlige grunnlaget. Kontakt GenderAPI.io hvis bruken din krever en vurdering av en bestemt kilde.
| Grunnlag | Nødvendig dokumentasjon | Offentlig status |
|---|---|---|
| Opprinnelse og bruksrett | Navngitt kilde eller utgiver, innsamlingsperiode, lisens eller et annet dokumentert grunnlag for bruken | Ingen gjennomgått katalog er publisert her |
| Behandlingshistorikk | Transformasjoner, normalisering, fjerning av duplikater, aggregering og eventuelle syntetiske eller modellgenererte bidrag | Vises ikke av etiketten source: dataset |
| Dekning av populasjonen | Dekning av land og skrifter, utvelgelsesprosess, definisjoner av etiketter og dokumentert skjevhet | Ingen uavhengig evaluerte dekningstall er publisert her |
| Aktualitet | Identifikatorer for øyeblikksbilder, oppdateringsdatoer per kilde og en fastsatt plan for oppdateringer | V2-svaret inneholder ingen opplysninger om aktualitet per rad og ingen identifikator for øyeblikksbildet |
| Kvalitet og retting | Valideringsresultater, kontroller av overlapp, håndtering av retting og sletting og ansvar for gjennomgangen | Ingen revisjonsresultater per kilde er publisert her |
Personvern, behandling og ansvarlig bruk
Kildenes opprinnelse, behandlingen av personopplysninger og de juridiske vilkårene er ulike spørsmål. Se de gjeldende publiserte retningslinjene for roller i behandlingen, lagringstid, leverandører og avtalevilkår. Denne tekniske veiledningen gir ingen nye løfter om lagring og bekrefter ikke at lovkrav er oppfylt.
Send bare opplysningene som arbeidsflyten din trenger. Behold konfidenstypene og ukjente resultater, og ikke beskriv en prediksjon som identiteten personen selv har oppgitt. Ikke bruk et utledet kjønn som grunnlag for beslutninger som har store konsekvenser for en person.
Grunnlag for nøyaktighet og endringshistorikk
En kildeetikett forklarer prediksjonsveien, ikke den målte kvaliteten. Bruk veiledningen om nøyaktighet for å skille mellom verdier i svaret, svardekning, feil og opplysningene som trengs for en reproduserbar evaluering.
| Dato | Dokumentversjon | Endring |
|---|---|---|
| 2026-09-29 | 1.0.0 | Norsk versjon av den daterte opptellingen i MongoDB, de avgrensede konsistenskontrollene i utvalgene, feltene source og match i V2, grensene for behandlingen med KI og hullene som gjenstår i kildekatalogen. Likheten mellom MongoDB og Redis bygger på bekreftelsen fra GenderAPI.io 26. september 2026; en uavhengig sammenligning gjenstår. Det innføres ingen nøyaktighetsprosent og ingen påstand om lisenser for kildene. |