# API płci dla imion, adresów e-mail i nazw użytkowników

> Oszacuj prawdopodobną płeć na podstawie imienia, pełnego imienia i nazwiska, adresu e-mail lub nazwy użytkownika. GenderAPI.io V2 zwraca uporządkowany JSON ze źródłem prognozy, wskaźnikiem pewności i opcjonalnym kontekstem kraju.

Canonical HTML: https://www.genderapi.io/pl

Last reviewed: 2026-09-28

## Informacje ogólne

Oszacuj prawdopodobną płeć na podstawie imienia, pełnego imienia i nazwiska, adresu e-mail lub nazwy użytkownika. GenderAPI.io V2 zwraca uporządkowany JSON ze źródłem prognozy, wskaźnikiem pewności i opcjonalnym kontekstem kraju.

## Przetestuj zapytanie V2 dla imienia

Każde zapytanie kosztuje 1 kredyt. Jeśli nie zapisano klucza lub nie został on rozpoznany, używana jest próba obejmująca 10 kredytów na 24 godziny, wspólnych dla adresu IP.

Przykładowa odpowiedź V2. Wyślij zapytanie, aby zobaczyć wynik na żywo.

**Reprezentatywna odpowiedź; nie jest to wynik zapytania na żywo**

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Onur",
      "country": null
    },
    "name": "onur",
    "gender": "male",
    "country": "TR",
    "confidence": 0.9,
    "confidence_kind": "observed_frequency",
    "sample_count": 100,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "onur",
      "method": "normalized",
      "scope": "global",
      "country": null
    }
  },
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 9,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

- [Otwórz demo na żywo na stronie HTML](https://www.genderapi.io/pl#name-demo)

## API płci stworzone dla imion z całego świata

Sprawdzaj pojedyncze rekordy, wysyłaj partie albo korzystaj z naszych narzędzi do arkuszy kalkulacyjnych. V2 odróżnia wyniki z prognozą od wyników bez prognozy, dzięki czemu Twoja aplikacja zachowuje niepewność zamiast wymuszać oszacowanie.

Pokrycie zależy od imienia i kraju: Cały świat

Wskaźnik pewności wraz ze źródłem i sposobem interpretacji: 0–1

Wyniki i zużycie kredytów w formacie JSON: V2

Rekordów w partii z kluczem API; 10 w próbie dla adresu IP: 50

## Określaj płeć na podstawie imienia lub imienia i nazwiska

Otrzymasz oszacowanie wraz ze wskaźnikiem pewności i źródłem prognozy. Gdy prognoza nie jest dostępna, V2 wyraźnie to sygnalizuje.

- Same imiona oraz imiona z nazwiskami

- Opcjonalny kontekst kraju, jeśli jest znany

- Imiona zapisane alfabetem łacińskim i innymi systemami pisma

- [Zobacz API V2 dla imion →](https://www.genderapi.io/pl/docs/v2/gender-from-name)

## Wykorzystaj sygnały imienia zawarte w adresie e-mail

Analizuj sygnały imienia w popularnych formatach adresów e-mail. Dodawaj oszacowanie i jego źródło do rekordów CRM, leadów i analiz.

- Adresy prywatne i firmowe

- Wzbogacanie rekordów CRM

- Pewność i źródło w odpowiedzi

- [Zobacz API V2 dla adresów e-mail →](https://www.genderapi.io/pl/docs/v2/gender-from-email)

## Analizuj nazwy użytkowników i pseudonimy

Wyszukuj rozpoznawalne imiona w nazwach użytkowników. Opcja forceToGenderize pozwala podjąć próbę oszacowania także dla pseudonimów, które nie zawierają prawdziwego imienia; nie gwarantuje jednak uzyskania prognozy.

- Użytkownicy serwisów społecznościowych i społeczności internetowych

- Opcjonalna analiza pseudonimów

- Wyraźny status, gdy brak prognozy

- [Zobacz API V2 dla nazw użytkowników →](https://www.genderapi.io/pl/docs/v2/gender-from-username)

## Przetwarzaj listy imion w partiach

Prześlij plik Excel lub CSV, wybierz kolumnę źródłową i pobierz wyniki. Aby wysyłać partie z własnej aplikacji, skorzystaj z przewodnika po zapytaniach zbiorczych V2.

- Pliki Excel i CSV

- Kolumny z imionami, imionami i nazwiskami lub adresami e-mail

- Opcjonalny kontekst kraju

- [Zobacz przewodnik po partiach V2 →](https://www.genderapi.io/pl/docs/v2/batch)

## Zintegruj API lub połącz gotowe narzędzia

Zacznij od REST API albo połącz GenderAPI.io z arkuszami kalkulacyjnymi, platformami e-commerce i narzędziami automatyzacji. W każdym przewodniku sprawdź, z której wersji API korzysta dana integracja.

- [Zobacz wszystkie integracje](https://www.genderapi.io/pl/integrations)

## Co warto wiedzieć przed rozpoczęciem

Poznaj rodzaje zapytań, wskaźnik pewności, bezpłatny dostęp i koszt w kredytach. Formaty zapytań i przykłady kodu znajdziesz w dokumentacji V2.

- [Zobacz wszystkie pytania →](https://www.genderapi.io/pl/frequently-asked-questions)

### Czym jest GenderAPI.io?

GenderAPI.io szacuje prawdopodobną płeć na podstawie imienia, adresu e-mail lub nazwy użytkownika. V2 zwraca prognozę, pewność, źródło i zużycie kredytów w formacie JSON. Są to oszacowania oparte na wzorcach imion; nie weryfikują one tożsamości płciowej deklarowanej przez daną osobę.

### Kiedy V2 korzysta ze sztucznej inteligencji?

Pojedyncze zapytanie najpierw sprawdza zbiór danych. Jeśli nie znajdzie w nim prognozy, domyślnie korzysta z AI. Ten standardowy tryb, łącznie z użyciem AI, kosztuje w sumie 1 kredyt. W zapytaniach zbiorczych AI jest domyślnie wyłączona. Możesz wybrać tryb AI lub włączyć forceToGenderize, aby analizować pseudonimy.

### Jak interpretować pewność i wyniki bez prognozy?

Pole confidence w V2 zawiera wartość od 0 do 1 albo null. Pole confidence_kind odróżnia częstotliwość zaobserwowaną w zbiorze danych od pewności zgłoszonej przez model; wskaźnik ten nie gwarantuje poprawności wyniku. Gdy brak prognozy, odpowiedź zawiera gender: null i result_status: unknown.

### Ile kredytów kosztuje jedno zapytanie?

Standardowe zapytanie V2 kosztuje 1 kredyt, również wtedy, gdy użyto AI, oraz wtedy, gdy pomyślnie przetworzony wynik nie zawiera prognozy. Tryb AI always kosztuje 2 kredyty. Z opcją forceToGenderize prognoza ze zbioru danych kosztuje 1 kredyt; jeśli zostanie użyta AI, łączny koszt wynosi 2 kredyty. W zapytaniach zbiorczych koszt jest liczony osobno dla każdego rekordu.

### Czy mogę wysłać wiele rekordów w jednym zapytaniu?

Tak. V2 przyjmuje do 50 rekordów w partii z ważnym kluczem API albo do 10 w próbie dla adresu IP. Jedno zapytanie HTTP może więc zużyć wiele kredytów. Większe pliki możesz przetwarzać także za pomocą narzędzi Excel i CSV lub innych integracji.

### Czy mogę wypróbować API bezpłatnie?

Bez klucza API demo V2 korzysta z próby obejmującej 10 kredytów na 24 godziny, wspólnych dla wszystkich osób korzystających z tego samego adresu IP. Bezpłatne konto otrzymuje 200 kredytów dziennie. Są to limity kredytów, a nie stała liczba zapytań: tryby kosztujące 2 kredyty szybciej wyczerpują saldo.

### Czy mój obecny klucz API działa z V2?

Tak. V1 i V2 korzystają z tego samego klucza API i tego samego salda konta. Istniejące integracje V1 pozostają dostępne. Nowe integracje opieraj na dokumentacji V2, ponieważ jej endpointy, pola odpowiedzi i format błędów różnią się od V1.

## Wypróbuj GenderAPI.io bezpłatnie

Załóż konto, przetestuj pierwsze zapytania z 200 bezpłatnymi kredytami dziennie i przetwarzaj pliki Excel lub CSV, gdy będzie to potrzebne.

- [Utwórz konto](https://app.genderapi.io/user/register)
- [Czytaj dokumentację](https://www.genderapi.io/pl/api-documentation)