Vad betyder source i V2?
Fältet source visar vilken väg som gav det slutliga resultatet: sökningen i den lagrade datamängden, en AI-inferens eller ingen vald källa. Det är varken en hänvisning till den ursprungliga utgivaren av en post, ett licensbevis eller en garanti för att inferensen är korrekt.
Den här guiden beskriver det nuvarande svarskontraktet i V2 och en databasprofil som GenderAPI.io har tagit fram. Observationerna nedan är inventeringsmätningar och konsekvenskontroller; en granskad katalog över de ursprungliga källorna och en oberoende utvärdering av noggrannheten har ännu inte publicerats.
| source | Betydelse | Vad det inte visar |
|---|---|---|
dataset | En lagrad post valdes; vid exakt lika frekvenser kan könet ändå vara okänt | Ursprunglig utgivare, insamlingsmetod, licens, postens ålder eller observationernas oberoende |
ai | Det slutliga svaret kommer från den konfigurerade vägen för AI-inferens; gender kan ändå vara null | Ett räknat urval, en hänvisning till datamängden eller en kalibrerad noggrannhet för prediktionen |
none | I läget som bara använder datamängden valdes ingen lagrad post för det slutliga resultatet | Att indata saknar en möjlig namnkoppling i alla populationer och alla språk |
Databasprofil: 26 september 2026
Samlingarnas metadata lästes 2026-09-26T15:28:18.227Z och de slumpmässiga urvalen togs 2026-09-26T15:31:54.045Z. De två dokumentantalen kommer var för sig från MongoDB-metadata från collStats för respektive samling och inte från en oberoende fullständig räkning. Den allmänna samlingen innehåller namnposter och den landsspecifika samlingen par av namn och land. Lägg inte ihop talen för att få ett totalt antal unika namn eller unika personer.
För varje samling valde MongoDB slumpmässigt ut 5 000 dokument och beräknade de aggregerade kontrollerna nedan på serversidan. Den offentliga rapporten innehåller inga namn och inga rådata. Det är observationer som GenderAPI.io har gjort i den driftsatta databasen, inte en oberoende granskning eller en fryst utvärderingsdatamängd. Kontrollerna gäller räknarnas konsekvens, inte prediktionernas noggrannhet, antalet personer eller unika namn och inte API:ets täckning.
| Observation | Allmänna poster | Landsspecifika poster |
|---|---|---|
| Samling | general | country-specific |
| Antal dokument enligt metadata | 2 483 220 | 4 080 692 |
| Lagrad unik nyckel | name | name + country |
| Slumpmässigt valda dokument | 5 000 | 5 000 |
| Misslyckade numeriska kontroller i urvalet | 0 | 0 |
| male + female skiljer sig från total i urvalet | 0 | 0 |
| Lika frekvenser för male och female i urvalet | 124 | 94 |
| Fältet updated_at finns i urvalet | 667 / 5 000 | 741 / 5 000 |
Vad databaskontrollerna visar
Den numeriska kontrollen kräver att total är ett positivt säkert heltal och att frekvenserna male och female är ändliga och ligger mellan noll och total. En separat kontroll jämför male + female med total. Alla räknare i urvalen klarade kontrollerna; det betyder varken att varje post i samlingarna är konsekvent eller att någon prediktion är korrekt.
Lika frekvenser för male och female förekom i 124 poster i urvalet från den allmänna samlingen och i 94 poster i urvalet från den landsspecifika samlingen. Det är lika lagrade frekvenser, inte oberoende granskade tvetydiga identiteter och inte någon andel okända API-resultat. Faktiska API-resultat beror på indata, tillgången till Redis, valet av kandidater och AI-inställningarna.
En separat inventering av fältet country i den allmänna samlingen, gjord 2026-09-26T15:33:13.811Z, gav 244 olika lagrade värden: 239 i formatet två versaler och 5 i ett annat format. Överensstämmelse med ISO, postfördelning per land och täckning av länder som stöds mättes inte. Talen är inte antalet länder som stöds.
Inga fält för källa eller licens förekom i något av urvalen. Det visar inte att ursprungsuppgifter saknas i varje post eller i externa system: att ett fält finns eller saknas är inget bevis på en källas licens. Fältet updated_at förekom i vissa poster som ett numeriskt värde, men dess värden och betydelse granskades inte; det visar varken hur aktuella uppgifterna är eller någon plan för uppdateringar.
V2 hämtar sökningarna i datamängden från Redis. Den 26 september 2026 bekräftade GenderAPI.io som systemets ägare att MongoDB och Redis innehåller samma datamängd. Likvärdigheten bygger på den bekräftelsen: någon oberoende jämförelse av de två databaserna har inte gjorts, och den kontrollen återstår. Inventeringen ovan beskriver lagrade poster; API:ets svarstäckning beror dessutom på skickade indata, matchningen av kandidater och AI-inställningarna. Urvalen togs utan fast seed, lästes utan fryst ögonblicksbild och togs fram utan oberoende referensetiketter; de gör det inte möjligt att mäta prediktionernas noggrannhet, kalibreringen eller svarstäckningen.
Spåra uppgifterna i svaret
| Fält | Betydelse | Begränsning |
|---|---|---|
input | Upprepar den skickade typen, värdet och landskontexten | Ett indatavärde är ingen oberoende granskad identitetsuppgift |
match.name / match.method | Visar den valda kandidaten och om den normaliserades, extraherades som del eller delsträng eller härleddes av modellen | En träff på en del garanterar inte att ett riktigt förnamn extraherades ur det fullständiga namnet eller identifieraren |
match.scope / match.country | Visar om den valda posten kommer från den landsspecifika eller den globala sökningen | Att ett land anges garanterar inte att en landsspecifik post fanns tillgänglig |
sample_count | Det totala antal som lagras i den valda posten; null vid AI-inferens | Behöver varken betyda unika personer, oberoende insamlade observationer eller urvalsstorleken i en utvärdering av noggrannheten |
confidence / confidence_kind | Skiljer en kvot som beräknats ur lagrade frekvenser från ett värde som modellen rapporterar | Inget av värdena är en granskad sannolikhet för en persons könsidentitet |
country / country_source | Landsmetadata för den returnerade posten eller en landskoppling för namnet som AI rapporterar, när sådana finns | Innebär varken nationalitet, bostadsort eller granskat ursprung och visar inte att det skickade landet matchades |
Hur matchningen av indata påverkar resultatet
Sökningen i datamängden normaliserar texten och härleder kandidater ur den. För e-postadresser kommer kandidaterna från delen före @; för användarnamn tas ett valfritt inledande @ bort. Vanliga sökningar efter e-postadresser och användarnamn kan dessutom kontrollera delsträngar av begränsad längd. Om flera kandidatposter finns väljs den med det största lagrade totala antalet; det kan vara en annan del än det avsedda förnamnet.
När en landskontext anges kontrollerar sökningen för varje kandidat den landsspecifika posten och, om ingen sådan finns, den globala posten. Det slutliga resultatet anger den valda träffen. En tvetydig landsspecifik post ersätts inte automatiskt av den globala posten för den kandidaten.
Den vanliga AI-prompten letar efter ett igenkännbart förnamn. forceToGenderize tillåter dessutom kopplingar utifrån personliga smeknamn eller alias: i det läget är ett kön som inte är null tillsammans med name: null ett giltigt resultat. Det är olika inferensuppgifter som måste utvärderas separat.
Sökning i datamängden och behandling med AI
När AI används skickar V2 den skickade type, value och landskontexten till den konfigurerade tjänsten för AI-inferens. För e-postadresser instruerar prompten modellen att bortse från domänen och tillägget efter ett +; det garanterar inte att tecknen tas bort ur värdet innan AI behandlar det. Om ditt flöde kräver en prediktion som bara bygger på datamängden använder du ai_mode: off utan forceToGenderize.
Valideringen av AI-svaret kontrollerar JSON-fälten, deras typer och deras inbördes konsekvens. Den visar inte att det returnerade namnet, könskopplingen eller landskopplingen stämmer. Det offentliga resultatet innehåller varken en identifierare eller version för modellen eller någon källa som motiverar dess inferens.
| Alternativ | Inferensväg | Returnerade uppgifter |
|---|---|---|
| ai_mode: off | Endast sökning i datamängden | Metadata för den valda posten eller ett okänt resultat utan vald post |
| ai_mode: fallback | Kontrollerar datamängden först; använder AI om inget kön returnerades | Uppgifter från den slutliga vägen, inget kombinerat urval från datamängden och AI |
| ai_mode: always | Använder den konfigurerade vägen för AI-inferens direkt | Ett värde som modellen rapporterar eller ett okänt resultat med konfidensen null; sample_count är alltid null |
| forceToGenderize: true | Kontrollerar datamängden och använder vid ett öppet resultat AI som tar hänsyn till smeknamn | Uppgifter från datamängden eller en smeknamnskoppling som modellen rapporterar; name kan vara null |
Källdokumentation som ännu inte har publicerats
Ingen granskad källkatalog har publicerats här. Svarskontraktet och implementeringens beteende räcker inte ensamma för att granska uppgifternas ursprung, rätten att använda en källa, dess representativitet eller kvaliteten på dess etiketter. Innan påståenden om specifika källor görs måste uppgifterna nedan vara dokumenterade och granskade.
Den här översikten över dokumentationen fastställer varken om de ursprungliga källorna är licensierade eller inte eller om de är fullständiga eller ofullständiga. Den beskriver begränsningarna i det offentligt tillgängliga underlaget. Kontakta GenderAPI.io om ditt användningsfall kräver en bedömning av en viss källa.
| Underlag | Dokument som krävs | Offentlig status |
|---|---|---|
| Ursprung och användningsrätt | Namngiven källa eller namngiven utgivare, insamlingsperiod, licens eller en annan dokumenterad grund för användningen | Ingen granskad katalog har publicerats här |
| Bearbetningshistorik | Transformationer, normalisering, borttagning av dubbletter, aggregering och varje syntetiskt eller modellgenererat bidrag | Framgår inte av etiketten source: dataset |
| Populationstäckning | Täckning av länder och skriftsystem, urvalsförfarande, etikettdefinitioner och dokumenterade snedvridningar | Inga oberoende utvärderade täckningsdata har publicerats här |
| Aktualitet | Identifierare för ögonblicksbilder, uppdateringsdatum för enskilda källor och en plan för uppdateringar som stöds | V2-svaret innehåller varken uppgifter om enskilda posters aktualitet eller en identifierare för ögonblicksbilden |
| Kvalitet och rättelser | Valideringsresultat, kontroller av överlappningar, hantering av rättelser och raderingar samt ansvar för granskningen | Inga granskningsresultat för enskilda källor har publicerats här |
Dataskydd, behandling och ansvarsfull användning
Källornas ursprung, behandlingen av personuppgifter och de rättsliga villkoren är separata frågor. Roller i behandlingen, lagringstider, leverantörer och avtalsvillkor beskrivs i de policyer som är publicerade för närvarande. Den här tekniska guiden ger inga nya åtaganden om lagring av uppgifter och intygar inte att regelverk efterlevs.
Skicka bara de uppgifter som ditt flöde behöver. Behåll konfidenstyper och okända resultat och framställ inte en inferens som den identitet en person själv har uppgett. Fatta inga beslut med stora konsekvenser för en person utifrån ett härlett kön.
Underlag om noggrannhet och ändringshistorik
Källetiketten förklarar inferensvägen, inte dess uppmätta kvalitet. Guiden om noggrannhet visar hur du skiljer mellan resultat i svar, svarstäckning, fel och de uppgifter som behövs för en reproducerbar utvärdering.
| Datum | Dokumentversion | Ändring |
|---|---|---|
| 2026-09-28 | 1.0.0 | Svensk version av den daterade inventeringen av MongoDB, konsekvenskontrollerna i urvalen, V2-fälten source och match, begränsningarna i behandlingen med AI och de kvarvarande luckorna i källkatalogen. Likvärdigheten mellan MongoDB och Redis bygger på GenderAPI.io:s bekräftelse den 26 september 2026; den oberoende jämförelsen återstår. Varken ett noggrannhetsvärde i procent eller ett påstående om källornas licens har lagts till. |