Unicode desteğini ad ve soyadı ayırma yeteneğinden ayırın
Çince ismi Latin harflerine dönüştürmeden Unicode metin olarak gönderebilirsiniz. Mevcut veri kümesi sorgusu normalleştirilmiş ad bileşenlerini arar; bitişik yazılmış Çince tam adı otomatik olarak ad ve soyada ayırmaz. Bu nedenle 王静怡 tek adaydır; 静怡 bölümünün ayrıca sorgulanacağı garanti edilmez.
Buradaki yaygın Çince karakterlerle yazılmış bir veya iki karakterlik bileşenler mevcut aday uzunluğu filtresinde elenir. Kısa bir ön ad geçerli girdi olsa bile veri kümesi adayı oluşturmayabilir. Standart yapay zekâ yedeklemesi özgün gönderilen değeri yine değerlendirebilir. Yalnızca veri kümesi modu ise unknown sonucunu korur.
Unicode NFKC normalleştirmesi, Basitleştirilmiş ve Geleneksel Çince arasında genel bir dönüşüm sağlamaz; Latin harfli yazımı da tek bir özgün Çince adla eşleştirmez. Gönderilen yazımı koruyup dönen eşleşmeyi inceleyin. Yalnızca soyadının konumundan, yazı sisteminden veya Latin harfli yazımdan kişinin cinsiyetini ya da ülkesini çıkarmayın.
| Örnek girdi | Ne gösteriyor? | Kontrol edilecek bilgi |
|---|---|---|
王静怡 | Bitişik yazılmış tam ad | Tek veri kümesi adayıdır. Mevcut ayrıştırıcı soyadını ayırmaz. |
静怡 | İki karakterlik ön ad | Veri kümesinin aday uzunluğu filtresinde elenir. Yapay zekâ yedeklemesi özgün değeri deneyebilir. |
王 静怡 | Ayrı yazılmış kısa bileşenler | Boşluk eklemek uzunluk filtresini aşmaz. Bu örnekteki iki bileşen de veri kümesi sorgusu için fazla kısadır. |
Wang Jingyi | Latin harfli girdi | Kendi bileşenlerine ayrılan ayrı bir girdidir. Özgün karakterlerle veya aynı kayıtla eşleşmesi garanti edilmez. |
CN ülke bağlamını bilinçli kullanın
Canlı demo country: CN (Çin) gönderir. API bu ülkeyi ismin yazı sisteminden seçmez. Entegrasyonunuzda bilinen ve ilgili ülke bağlamını kullanın veya country alanını göndermeyin. Bu örnek değeri bütün kayıtların varsayılanı yapmayın.
Veri kümesi sorgusu her aday için varsa ülkeye özel kaydı, yoksa genel kaydı değerlendirir. Ardından mevcut adaylar arasından kayıt toplamı en yüksek olanı seçer. Gerçek eşleşme kapsamını data.match.scope ve data.match.country ile inceleyin. Ülkeye özel kayıtta sayılar eşitse genel kayda otomatik geçilmez; açık olan fallback bunun yerine yapay zekâyı kullanabilir.
data.input.country istekteki ülke bağlamıdır. data.country ve data.country_source ise yanıttaki ülke ilişkisini ve kaynağını açıklar. Bunlar farklı alanlardır; vatandaşlık, etnik köken veya ikamet doğrulamaz.
Uygulamanızdan V2 isim sorgusu gönderin
GENDERAPI_API_KEY ortam değişkenini mevcut anahtarınıza ayarlayıp örneği sunucunuzda çalıştırın. Örnek standart yapay zekâ yedeklemesini açıkça etkinleştirir. Ölçülmüş tahmin başarısı veya veri kapsamı değil, istek biçimi gösterir. Yalnızca veri kümesi için options.ai_mode: off kullanı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.
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
Tahmini dayandığı bilgilerle birlikte değerlendirin
API’nin çıkardığı ilişki, kişinin kendi belirttiği cinsiyet değildir. Özgün girdiyi, yanıttaki kanıtları ve kişinin verdiği bilgileri ayrı saklayın. Tahmin bulunamaması geçerli bir sonuçtur; uygulamanızda bunu zorunlu bir cinsiyet kategorisine dönüştürmeyin.
| Alan | Nasıl kullanılmalı? |
|---|---|
data.gender / data.result_status | male veya female değerini yalnızca identified sonucunda kullanın. unknown sonucunda gerçek JSON null değerini koruyun. |
data.name / data.match | Dönen adı ve seçilen adayı inceleyin. Alt metin eşleşmesi, girdinin o ön ada sahip bir kişiye ait olduğunu kanıtlamaz. |
data.confidence / data.confidence_kind | Güven skoru 0–1 aralığında veya null olur. observed_frequency kayıtlı sayımlardan, model_reported yapay zekânın bildirdiği skordan gelir. Eşikleri her tür için ayrı değerlendirin. |
data.source / data.sample_count | dataset, ai ve none kaynaklarını ayırın. Yapay zekâ sonucunda kayıtlı örnek sayısı yoktur. Örnek sayısı, ölçülmüş doğruluk oranı değildir. |
meta.access.mode | Hesap entegrasyonunda api_key değerini doğrulayın. Anahtar eksik veya tanınmıyorsa ortak IP denemesi kullanılabilir. |
meta.usage | charged_credits ve billing_status alanlarını okuyun. Başarıyla tamamlanan unknown sonucu ücretlidir. Yanıtın ulaşmaması, işlemin ücretsiz olduğunu göstermez. |
Yapay zekânın ne zaman kullanılacağını seçin
forceToGenderize; isim, e-posta ve kullanıcı adı girdilerinde isteğe bağlıdır. Açıkken ai_mode alanını göndermeyin veya fallback kullanın. off ve always ile birlikte kullanılması 422 hatası verir. İsteğe başlamak için pozitif bakiye yeterlidir; son ücret bakiyeyi sıfırın altına düşürebilir.
Rumuz analizinde name: null iken cinsiyet tahmini dönebilir. Sonuç unknown da olabilir. Standart yedekleme veya rumuz analizi, doğru ya da dolu bir sonuç garantisi vermez.
| İstek seçeneği | Davranış | Tamamlanan sorgunun maliyeti |
|---|---|---|
| options.ai_mode: off | Yalnızca veri kümesini sorgular. | unknown dahil 1 kredi |
| options.ai_mode: fallback | Önce veri kümesini, cinsiyet tahmini bulunamazsa standart yapay zekâyı kullanır. Tekli sorguların varsayılanıdır. | Yapay zekâ yedeklemesi dahil toplam 1 kredi |
| options.ai_mode: always | Doğrudan yapay zekâya sorar. | 2 kredi |
| forceToGenderize: true | Önce veri kümesine bakar; tahmin bulunamazsa gerçek ön ad içermeyen kişisel rumuzların anlamını da yapay zekâyla yorumlayabilir. | Veri kümesinde tahmin bulunursa 1, yapay zekâ kullanılırsa toplam 2 kredi |
İsim listesini bağlamını kaybetmeden işleyin
POST /api/v2/gender/batch ile hesap anahtarında en fazla 50, IP denemesinde 10 öğe gönderin. Öğelere benzersiz id değerleri verin ve her satırın özgün girdisini saklayın. Her öğenin ülke ve yapay zekâ seçenekleri ayrı olabilir. Ülke bilinmiyorsa göndermeyin.
Tekli sorguların fallback varsayılanından farklı olarak toplu öğelerde varsayılan yalnızca veri kümesidir. Yapay zekâ gereken her öğede options.ai_mode: fallback seçin. HTTP 200 olsa bile her sonucu kontrol edin ve unknown değerlerini koruyun. Yeniden gönderimden önce öğe hatasını ve ücretlendirmeyi inceleyin. Başarıyla tamamlanan her standart öğe 1 kredidir; bir toplu HTTP isteği tek tahmin kredisi değildir.
Gönderdiğiniz verinin nasıl işlendiğini bilin
Canlı araç, girdiğiniz değeri yalnızca sorguyu gönderdiğinizde GenderAPI.io’ya iletir. Yapay zekâ devreye girerse gönderilen type, value ve ülke bağlamı yapılandırılmış tahmin servisine iletilir. Entegrasyonunuzda yalnızca veri kümesini kullanmak için forceToGenderize olmadan options.ai_mode: off gönderin.
Yayımlanmış veri işleme koşulları Gizlilik Politikası, Veri İşleme Anlaşması ve alt işleyiciler listesinde açıklanır. Tahmin, girdiden çıkarılan bir ilişkidir; kişinin kendi verdiği bilgiye öncelik tanıyın. Sonucu bir kişi hakkında önemli kararların dayanağı olarak kullanmayın.
Çince isim sorgulama hakkında sorular
İki karakterlik Çince isim neden yalnızca veri kümesi modunda unknown olabilir?
Mevcut aday filtresi JavaScript metin uzunluğu iki veya daha az olan bileşenleri eler. Burada gösterilen Çince karakterlerde iki karakterlik isim geçerli girdidir, ancak veri kümesi adayı olmaz. Yapay zekâ yedeklemesi özgün girdiyi değerlendirebilir.
V2 Çince soyadını ön addan otomatik ayırır mı?
Veri kümesi sorgusu, bitişik yazılmış Çince tam adı ad ve soyada ayırmaz. Yapay zekâ tam değerden bir ad çıkarabilir, ancak hiçbir yol amaçlanan ön adın seçileceğini garanti etmez. source ve match alanlarını kontrol edin.
Bu isim grubu için bağımsız doğruluk ölçümü yayımlanıyor mu?
Bu sayfada böyle bir ölçüm yayımlanmıyor. Girdinin kabul edilmesi, kayıtlı sayılar ve güven skoru bağımsız doğruluk testi değildir. Mevcut kanıtları ve henüz yayımlanmamış ölçümleri metodoloji sayfasından inceleyin.
Tahmin bulunamazsa kredi kullanılır mı?
Başarıyla tamamlanan unknown sonucu ücretlidir. Standart veri kümesi veya fallback modu toplam 1 kredidir. forceToGenderize açıkken veri kümesinde tahmin bulunursa 1, yapay zekâ kullanılırsa unknown dahil toplam 2 kredi düşülür. Hataların ücretlendirme kuralları ayrıdır; meta.usage alanını inceleyin.