Örnek girdiler
Lakap bir kimlik doğrulaması değildir
@alice_smith bir isim bileşeniyle eşleşebilir. prenses için forceToGenderize kullanıldığında isim null kalırken bir tahmin dönebilir. user47291 bilinmeyen kalabilir. Bunlar girdi örnekleridir; hiçbirine önceden cinsiyet sonucu atanmamıştır.
Analiz mantığı
Kullanıcı adı cinsiyet tahmini nasıl çalışır?
Sistem; kullanıcı adı veya görünen ad içindeki okunabilir isim parçalarını ve diğer dilsel sinyalleri değerlendirir. Normal AI kullanılabilir gerçek isim arar; forceToGenderize etkinse gerçek isim olmadan lakap yorumu yapılabilir. Sonuç, ilgili destekleyici alanlarla birlikte döndürülür; anlamsız veya yetersiz girdilerde sonuç zorlanmamalıdır.
Kullanım kanalları
Verinizin işlendiği yere uygun yöntemi seçin
Kodsuz toplu işlem
Excel veya CSV dosyasındaki kullanıcı adlarını dört adımda analiz edin
- 01
Excel/CSV aracını açın
GenderAPI Excel/CSV yükleme aracını açın ve işleyeceğiniz dosyayı yükleyin.
- 02
Kaynak sütunu seçin
Kullanıcı adı, görünen ad veya takma ad değerlerinin bulunduğu sütunu eşleyin.
- 03
Takma ad analizini etkinleştirin
Sosyal medya adları ve takma adları değerlendiren seçeneği açın.
- 04
Örnek veriyi test edip dışa aktarın
Önce temsili bir örnek üzerinde sonuçları inceleyin; ardından dosyanın tamamını işleyip zenginleştirilmiş çıktıyı indirin.
Yeni hesaplarda günlük 200 ücretsiz API kredisi bulunduğundan, tam dosyayı işlemeden önce temsili bir örnekle akışı doğrulayabilirsiniz.
Kullanım alanı
Gerçek bir ad bulunmadığında yardımcı sinyal olarak kullanın
Kullanıcı adı analizi; sosyal medya, topluluk, oyun ve kullanıcı üretimli profil verilerinde ad alanının boş olduğu durumlarda yardımcı olabilir. Gerçek ad veya e-posta gibi daha doğrudan ve izinli bir kaynak varsa uygun API uç noktasını seçin.
Sınırlamalar
Sonucu doğrulanmış kimlik olarak değerlendirmeyin
Her rumuz gerçek bir isim içermez; kültürel çağrışımlar kullanıcıdan kullanıcıya değişebilir ve aynı ifade farklı dillerde farklı anlam taşıyabilir. Sonuç bulunamadığında boş veya başarısız durumu kabul edin; zayıf veriden kesin sonuç üretmeye çalışmayın.
V2 uygulama rehberi
Kaynak veriyi ve tahmini ayrı saklayın
Özgün kayıt kimliğini koruyun. API profil sayfası açmaz, hesap sahipliğini veya kişinin kimliğini doğrulamaz. Ülke bağlamını yalnız elinizde güvenilir bilgi varsa gönderin; alan adından veya sayfanın dilinden ülke varsaymayın.
| Örnek girdi | Alan veya seçenek | Yorum |
|---|---|---|
| @alice_smith | data.name / data.match | Özgün kullanıcı adını koruyun; eşleşen parçayı doğrulanmış isim saymayın. |
| prenses | forceToGenderize: true | Gerçek isim olmadan lakap yorumu yapılabilir. Cinsiyet dönerken data.name null kalabilir; kişiye isim uydurmayın. |
| user47291 | data.result_status: unknown | Anlamsız veya yetersiz girdiler bilinmeyen kalabilir. Bu, otomatik tekrar nedeni değildir. |
Kullanıcı adını type: username ile gönderin; profil URL’sini göndermeyin. Veri kümesi araması baştaki @ işaretini kaldırır, metni normalleştirir, ayırıcı ve rakamlardan adaylar üretir. Normal aramada sınırlı önek/sonek eşleşmeleri eklenebilir; forceToGenderize bu ek alt dize adaylarını kullanmaz. Birden çok eşleşmede kayıtlı toplamı en yüksek satır seçilir. E-posta için type: email, gerçek isim için type: name kullanın.
İşleme biçimini ve kredi maliyetini seçin
| Seçenek | İşlem | Başarılı öğe maliyeti |
|---|---|---|
| options.ai_mode: off | Yalnız veri kümesi | 1 kredi |
| options.ai_mode: fallback | Önce veri kümesi; çözümlenmezse normal AI | AI dahil toplam 1 kredi |
| options.ai_mode: always | Doğrudan AI | 2 kredi |
| forceToGenderize: true | Önce veri kümesi; çözümlenmezse gerçek isim gerektirmeyen lakap yorumu | Çözümlenen veri kümesi sonucu 1; AI kullanılırsa toplam 2 kredi |
Tekli istekte varsayılan fallback, toplu öğelerde varsayılan off değeridir. forceToGenderize isim, e-posta ve kullanıcı adı için isteğe bağlıdır; ai_mode belirtilmemeli veya fallback olmalıdır. off ve always ile çelişir. Başarılı unknown sonuçlar da ücretlendirilir. Pozitif başlangıç bakiyesi yeterlidir; işlem sonunda bakiye sıfırın altına düşebilir.
Toplu istekte her kayda ayrı seçenek verin
Örnek girdiler belirli bir tahmin garantisi değildir. GENDERAPI_API_KEY değerini sunucu ortamında ayarlayın; anahtarı herkese açık istemci koduna koymayın. V1 ve V2 aynı hesap anahtarını ve bakiyeyi kullanır. Anahtarı /api/v2/usage ile kontrol edip meta.access.mode değerinin api_key olduğunu doğrulayın.
Programlama dilinizi seçin. API anahtarınızı ayarlayın, ardından örneği sunucunuzda çalıştırın.
Yeniden denemeler dahil her tahmin isteği yeni ve ücretlendirilebilir bir işlemdir. Örnekler otomatik yeniden deneme yapmaz. Yeni istekten önce ücretlendirme durumunu kontrol edin.
Çalıştırmadan önce: erişim ve hata yönetimi
Örnekleri sunucunuzda çalıştırın. İşlem ortamındaki GENDERAPI_API_KEY değişkenini mevcut anahtarınıza ayarlayın. Tanınmayan anahtar IP denemesine yönlenebildiğinden meta.access.mode değerinin api_key olduğunu doğrulayın.
HTTP 4xx ve 5xx JSON yanıtlarında hata gövdesi korunur ve program sıfırdan farklı çıkış koduyla sonlanır. Yeniden denemeden önce code, action ve meta.usage.billing_status alanlarını kontrol edin. HTTP 200 toplu yanıtlarda her öğenin data veya error alanını da inceleyin.
Hata ve yeniden deneme rehberi →POSIX kabuğunda cURL 7.76+. Terminalinizde çalıştırın. Çalıştırma ortamı dokümantasyonu
Node.js 22+; yerleşik fetch. example.mjs olarak kaydedin ve node example.mjs çalıştırın. Çalıştırma ortamı dokümantasyonu
Python 3.10+; standart kütüphane. example.py olarak kaydedin ve python3 example.py çalıştırın. Çalıştırma ortamı dokümantasyonu
cURL uzantılı PHP 8+. example.php olarak kaydedin ve php example.php çalıştırın. Çalıştırma ortamı dokümantasyonu
Java 17+; standart HTTP istemcisi. GenderApiExample.java olarak kaydedin ve java GenderApiExample.java çalıştırın. Çalıştırma ortamı dokümantasyonu
.NET 8+ konsol uygulaması. Konsol projesinde Program.cs olarak kullanın, ardından dotnet run çalıştırın. Çalıştırma ortamı dokümantasyonu
Go 1.22+; standart kütüphane. main.go olarak kaydedin ve go run main.go çalıştırın. Çalıştırma ortamı dokümantasyonu
Liste sonuçlarını ve yeniden denemeleri yönetin
POST /api/v2/gender/batch, API anahtarıyla en fazla 50, ortak IP denemesiyle 10 öğe kabul eder. Her öğeye kendi type, value ve options değerlerini verin. Normal AI yedeği istiyorsanız toplu öğede fallback seçimini açıkça belirtin. id her toplu istek içinde benzersiz olmalıdır; index gönderilen grup içinde sıfırdan başlar. Kendi iş ve kaynak satır kimliklerinizi ayrıca saklayın.
HTTP 200 bütün öğelerin başarılı olduğunu göstermez. identified, unknown ve error sonuçlarını ayrı işleyin; meta.summary.succeeded hem identified hem unknown öğeleri kapsar. data.gender, source, confidence_kind, confidence, match ve reason alanlarını birlikte değerlendirin. AI puanını veri kümesi oranıyla eşdeğer kabul etmeyin.
meta.usage.billing_status doğrulandıysa yalnız yeniden denenmesi uygun operasyonel hataları tekrar gönderin. unconfirmed veya kayıp yanıt durumunda durup ücretlendirmeyi netleştirin. Başarılı unknown dahil aynı kaydı tekrar göndermek yeni ücretli işlem oluşturur; tüm listeyi körlemesine yeniden göndermeyin.
Toplu istek sözleşmesi · Yanıt alanları · AI seçenekleri · Doğruluk ve güven değerlendirmesi · Veri işleme politikası
Excel, Google Sheets ve diğer hazır eklentiler kendi bağlantı ve çıktı düzenini kullanabilir. Bu V2 JSON şemasını eklenti çıktısı olarak varsaymayın; ilgili güncel uygulama rehberini izleyin.
Sık sorulan sorular
Kullanıcı adı ve takma ad analizi hakkında
Kullanıcı adından cinsiyet tahmini yapılabilir mi?
V2’de forceToGenderize etkinse önce veri kümesi denenir; cinsiyet çözümlenmezse AI gerçek isim gerektirmeden lakabı yorumlayabilir. Sonuç bilinmeyen kalabilir ve doğrulanmış kimlik değildir. Normal AI ise kullanılabilir gerçek bir isim gerektirir.
Hangi kullanıcı adları daha uygun sonuç verir?
Gerçek isim, okunabilir takma ad veya belirgin isim bileşeni içeren değerler daha anlamlı sinyal sağlayabilir. Rastgele karakterler ve marka adları sonuç vermeyebilir.
Tek kullanıcı adı API ile analiz edilebilir mi?
Evet. Tekli kullanıcı adı API uç noktası bir kaydı analiz etmek için kullanılabilir. Çoklu kayıtlar için ayrı bir toplu API uç noktası bulunur.
Excel veya CSV dosyası yüklenebilir mi?
Evet. Dosya aracında kullanıcı adı ya da görünen ad sütununu seçip takma ad analizini etkinleştirebilirsiniz.
V2 güven ve kaynak alanları neden birlikte saklanmalı?
V2 data.confidence değeri 0–1 aralığındadır. source ve confidence_kind ile birlikte değerlendirin; AI puanı ile veri kümesi oranı aynı ölçüm değildir. unknown sonuçları ve reason alanını koruyun.
Sonuç pazarlama segmentasyonunda kullanılabilir mi?
Toplu eğilim analizi ve veri zenginleştirme için yardımcı sinyal olabilir; ancak birey hakkında yüksek etkili karar vermek veya kesin kimlik varsaymak için tek başına kullanılmamalıdır.
Ücretsiz test edilebilir mi?
Yeni GenderAPI hesaplarında temsili örneklerle API veya dosya akışını denemek için günlük 200 ücretsiz API kredisi bulunur.
