V2 yanıtındaki source ne anlama gelir?
source, nihai sonucu üreten yolu gösterir: kayıtlı veri kümesi, AI çıkarımı veya seçilmiş kaynağın bulunmaması. Verinin ilk yayımlayıcısına atıf, lisans belgesi veya tahminin doğruluğuna dair garanti değildir.
Bu rehber V2 yanıt yapısını ve GenderAPI’nin kendi veri tabanı incelemesini açıklar. Aşağıdaki envanter ve tutarlılık kontrolleri ölçülmüştür; incelenmiş ilk kaynak kataloğu ve bağımsız doğruluk değerlendirmesi henüz yayımlanmamıştır.
| source | Gösterdiği bilgi | Kanıtlamadığı bilgi |
|---|---|---|
dataset | Kayıtlı bir satır seçildi; sayılar eşitse cinsiyet yine bilinmeyen olabilir | İlk yayımlayıcı, toplama yöntemi, lisans, kayıt yaşı veya gözlemlerin bağımsızlığı |
ai | Nihai sonuç yapılandırılmış AI yolundan geldi; gender yine null olabilir | Sayılmış örneklem, veri kümesi atfı veya kalibre edilmiş doğruluk |
none | Yalnız veri kümesiyle üretilen nihai sonuç için kayıt seçilmedi | Girdinin hiçbir dil veya toplulukta isim ilişkisi bulunmadığı |
Veri tabanı envanteri: 26 Eylül 2026
Koleksiyon metaverisi 2026-09-26T15:28:18.227Z, rastgele örnekler 2026-09-26T15:31:54.045Z tarihinde okundu. Kayıt sayıları ayrı bir tam sayımdan değil, MongoDB collStats metaverisinden alındı. Genel koleksiyon isim kayıtları, ülke koleksiyonu isim–ülke kayıtları içerir. Bu sayılar toplanarak benzersiz isim veya kişi sayısı elde edilemez.
Her koleksiyondan MongoDB tarafından rastgele seçilen 5.000 belge üzerinde aşağıdaki toplu kontroller veri tabanı sunucusunda hesaplandı. Kamuya açık rapor ham isim veya kayıt içermez. Bunlar canlı veri tabanında GenderAPI tarafından yapılan gözlemlerdir; bağımsız denetim veya dondurulmuş değerlendirme veri kümesi değildir.
| Gözlem | Genel kayıtlar | Ülkeye özel kayıtlar |
|---|---|---|
| Koleksiyon | general | country-specific |
| Metaverideki belge sayısı | 2.483.220 | 4.080.692 |
| Saklanan benzersiz anahtar | name | name + country |
| Rastgele örneklenen belge | 5.000 | 5.000 |
| Örneklemde sayısal kural ihlali | 0 | 0 |
| Örneklemde male + female ile total uyuşmazlığı | 0 | 0 |
| Örneklemde eşit male ve female sayısı | 124 | 94 |
| Örneklemde updated_at alanı bulunan belge | 667 / 5.000 | 741 / 5.000 |
Bu kontroller neyi doğrular?
Sayısal kontrol, total değerinin pozitif ve güvenli bir tam sayı olmasını; male ve female değerlerinin sonlu ve sıfır ile total arasında olmasını gerektirir. Ayrı bir kontrol male + female toplamını total ile karşılaştırır. Örneklenen tüm sayaçlar bu kontrolleri geçti; bu, bütün kayıtların tutarlı veya tahminlerin doğru olduğu anlamına gelmez.
Genel örneklemde 124, ülkeye özel örneklemde 94 satırda male ve female sayıları eşitti. Bunlar kayıtlı sayılardaki eşitliklerdir; bağımsız doğrulanmış kimlikler veya API’nin bilinmeyen sonuç oranı değildir. API sonucu girdiye, Redis erişimine, aday seçimine ve AI ayarlarına bağlıdır.
2026-09-26T15:33:13.811Z tarihli ayrı genel koleksiyon incelemesinde country alanında 244 farklı değer bulundu. Bunların 239 tanesi iki büyük harf biçimine uyuyor, 5 tanesi uymuyordu. ISO üyeliği, ülkeye özel kayıt dağılımı ve desteklenen ülke kapsamı ölçülmedi. Bunlar desteklenen ülke sayısı değildir.
İki örneklemde kaynak veya lisans alanı görülmedi. Bu bulgu, her kayıtta veya dış sistemlerde kaynak bilgisinin bulunmadığını kanıtlamaz. Bazı kayıtlarda sayısal updated_at alanı vardı; değerleri ve anlamı incelenmediği için güncellik veya güncelleme sıklığı çıkarılamaz.
V2 veri kümesi sorgularını Redis üzerinden yanıtlar. GenderAPI, MongoDB ile Redis’in aynı veri kümesini içerdiğini teyit etmiştir. Envanter kayıtları tanımlar; API’nin yanıt kapsamı girdilere, aday eşleşmesine ve AI ayarlarına da bağlıdır. Örnekler sabit bir rastgelelik tohumu veya dondurulmuş anlık görüntü olmadan alındı ve bağımsız referans etiket içermiyor. Bu nedenle tahmin doğruluğu, kalibrasyon veya yanıt kapsamı ölçülemez.
Yanıttaki kanıt alanlarını okuyun
| Alan | Anlamı | Sınırı |
|---|---|---|
input | Girdi türünü, değerini ve gönderilen ülke bağlamını yansıtır | Bağımsız doğrulanmış kimlik bilgisi değildir |
match.name / match.method | Seçilen aday ile normalizasyon, parçalama, alt dize veya model çıkarımı yöntemini gösterir | Tam isim veya kullanıcı adından gerçek ön adın ayrıldığını garanti etmez |
match.scope / match.country | Seçilen kayıt ülkeye özel mi, genel mi gösterir | Ülke göndermek, ülkeye özel kayıt bulunduğu anlamına gelmez |
sample_count | Seçilen kaydın total değeri; AI sonucunda null | Benzersiz kişi sayısı, bağımsız gözlem veya doğruluk örneklemi olmak zorunda değildir |
confidence / confidence_kind | Kayıt sayısı oranıyla modelin bildirdiği puanı ayırır | Kişinin cinsiyet kimliğinin doğrulanmış olasılığı değildir |
country / country_source | Varsa kaydın ülke metaverisi veya AI’nin isimle kurduğu ülke ilişkisi | Uyruk, ikamet, doğrulanmış köken veya gönderilen ülkenin eşleştiğinin kanıtı değildir |
Girdi eşleştirmesi sonucu nasıl etkiler?
Veri kümesi araması metni normalize eder ve aday parçalar çıkarır. E-postada @ işaretinden önceki bölüm, kullanıcı adında varsa baştaki @ kaldırılarak kalan değer kullanılır. Normal e-posta ve kullanıcı adı aramaları sınırlı alt dize adaylarını da deneyebilir. Birden çok aday kaydı bulunduğunda kayıtlı total değeri en büyük olan seçilir; bu, amaçlanan ön addan farklı bir parça olabilir.
Ülke bağlamı gönderildiğinde her aday için ülkeye özel kayıt denenir; yoksa genel kayıt kullanılır. Nihai yanıt seçilen eşleşmeyi gösterir. Ülkeye özel kayıtta sayılar eşitse bu aday otomatik olarak genel kayıtla değiştirilmez.
Normal AI promptu tanınabilir bir kişi adı arar. forceToGenderize, kişisel lakap veya takma ad ilişkilerine de izin verir; bu modda name: null ile birlikte cinsiyet dönmesi geçerlidir. Bunlar farklı çıkarım görevleridir ve ayrı ölçülmelidir.
Veri kümesi ve AI işleme yolları
AI çağrıldığında gönderilen type, value ve ülke bağlamı yapılandırılmış AI servisine iletilir. E-postalar için prompt, alan adını ve artı adresleme ekini dikkate almamasını ister; bu parçaların AI’ye gönderilmeden önce değerden çıkarıldığı anlamına gelmez. Yalnız veri kümesiyle çalışmak için forceToGenderize kullanmadan ai_mode: off seçin.
AI yanıt doğrulaması JSON alanlarını, türlerini ve alanlar arası tutarlılığı kontrol eder. Dönen isim, cinsiyet veya ülke ilişkisinin doğru olduğunu kanıtlamaz. Kamuya açık sonuçta model kimliği, model sürümü veya çıkarıma kaynak atfı bulunmaz.
| Seçenek | İşleme yolu | Dönen kanıt |
|---|---|---|
| ai_mode: off | Yalnız veri kümesi | Seçilen kayıt bilgisi veya kayıt seçilmemiş bilinmeyen sonuç |
| ai_mode: fallback | Önce veri kümesi; cinsiyet dönmezse AI | Nihai yolun bilgisi; birleştirilmiş veri kümesi ve AI örneklemi değildir |
| ai_mode: always | Doğrudan yapılandırılmış AI yolu | Model puanı veya null güven puanıyla bilinmeyen sonuç; sample_count her zaman null |
| forceToGenderize: true | Önce veri kümesi; sonuç çözülemezse takma ad yorumlayabilen AI | Veri kümesi bilgisi veya modelin kurduğu takma ad ilişkisi; name null olabilir |
Henüz yayımlanmamış kaynak belgeleri
İncelenmiş bir ilk kaynak kataloğu burada yayımlanmamıştır. Yanıt yapısı ve uygulama davranışı tek başına verinin kökenini, kullanım iznini, temsiliyetini veya etiketlerin kalitesini doğrulayamaz. Kaynağa özel iddialar için aşağıdaki kayıtların belgelenmesi ve incelenmesi gerekir.
Bu inceleme kaynakların lisanslı, lisanssız, eksiksiz veya eksik olduğunu belirlemez; kamuya açık kanıtın sınırlarını açıklar. Kullanımınız kaynağa özel değerlendirme gerektiriyorsa GenderAPI ile iletişime geçin.
| Kanıt | Gereken kayıt | Yayımlanmış durum |
|---|---|---|
| Köken ve kullanım izni | Kaynak/yayımlayıcı adı, toplama dönemi, lisans veya belgelenmiş kullanım dayanağı | İncelenmiş katalog yayımlanmadı |
| İşleme geçmişi | Dönüştürme, normalizasyon, tekilleştirme, birleştirme, sentetik veya model üretimi katkılar | source: dataset etiketi bunları açıklamaz |
| Topluluk kapsamı | Ülke ve yazı sistemi kapsamı, seçim süreci, etiket tanımları ve yanlılıklar | Bağımsız değerlendirilmiş kapsam sayıları yayımlanmadı |
| Güncellik | Anlık görüntü kimlikleri, kaynak güncelleme tarihleri ve desteklenen takvim | V2 yanıtında kayıt güncelliği veya anlık görüntü kimliği yok |
| Kalite ve düzeltme | Doğrulama, örtüşme kontrolü, düzeltme/silme süreçleri ve inceleme sorumluluğu | Kaynağa özel denetim sonuçları yayımlanmadı |
Gizlilik ve sorumlu kullanım
Veri kökeni, kişisel veri işleme ve hukuki koşullar farklı konulardır. İşleme rolleri, saklama, sağlayıcılar ve sözleşme koşulları için yayımlanmış güncel politikalara bakın. Bu teknik rehber yeni bir saklama taahhüdü veya hukuki uygunluk belgesi oluşturmaz.
Yalnız iş akışınız için gereken bilgileri gönderin. Güven türlerini ve bilinmeyen sonuçları koruyun; çıkarımı kişinin kendi kimlik beyanı gibi sunmayın. Çıkarımla elde edilen cinsiyeti kişi hakkında önemli sonuçlar doğuran kararların temeli yapmayın.
Doğruluk kanıtı ve inceleme geçmişi
Kaynak etiketi çıkarım yolunu açıklar; ölçülmüş kaliteyi göstermez. Güven puanı, yanıt kapsamı, hatalar ve tekrarlanabilir değerlendirme arasındaki farklar için doğruluk rehberini inceleyin.
| Tarih | Belge sürümü | Değişiklik |
|---|---|---|
| 2026-09-27 | 1.0.0 | Türkçe rehbere tarihli MongoDB envanteri, sınırlı örneklem kontrolleri, V2 kaynak alanları ve AI işleme sınırları aktarıldı. MongoDB–Redis eşliği GenderAPI teyidine dayanır. Yeni doğruluk yüzdesi veya kaynak lisansı iddiası eklenmedi. |