POST AI agent ready /v1/gender/estimate

API определения пола — прогнозирование пола по имени

Прогнозирует пол, связанный с именем, с помощью статистических моделей, обученных на общедоступных демографических данных. Возвращает «мужской» или «женский» с оценкой вероятности (0–1) и количеством выборок. При желании можно сузить результаты по стране для обеспечения точности в зависимости от региона.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/gender/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria","country_id":"US"}'

When to use this API

Персонализированные приветствия по электронной почте

Если в вашей CRM есть имя, но нет поля пола, используйте эту конечную точку, чтобы предсказать пол и сгенерировать соответствующие приветствия («Уважаемый мистер Смит» или «Уважаемая госпожа Джонсон»). Применяйте прогнозы только с вероятностью выше 0,90, чтобы избежать ошибок.

Демографическое обогащение опросов и аналитики

Дополните ответы на опросы или пользовательскую аналитику прогнозируемым полом, если информация не собиралась напрямую. Используйте данные для составления сводных отчетов о гендерном распределении по вашей пользовательской базе, моделях использования продукта или результатах A/B-тестирования.

Frequently asked questions

Какие значения возвращает гендерное поле?

Поле пола возвращает «мужской» или «женский» на основе статистического большинства для этого имени. Для имен с почти равной вероятностью (например, «Алекс») ответ отражает незначительное большинство, и вероятность будет близка к 0,50.

Что означает показатель вероятности?

Вероятность — это значение от 0 до 1, указывающее на достоверность. Оценка 0,98 означает, что 98% людей с таким именем в наборе данных идентифицируют себя с предсказанным полом. Оценка ниже 0,60 указывает на то, что имя явно унисекс.

Влияет ли Country_id на результаты?

Да. Некоторые имена имеют разные гендерные ассоциации в разных странах. «Андреа» в англоязычных странах преимущественно женщина, а в Италии — мужчина. Предоставление Country_id дает более точные региональные прогнозы.

Как мне следует обрабатывать прогнозы с низкой вероятностью?

Для прогнозов с вероятностью ниже 0,70 считайте имя неоднозначным с гендерной точки зрения. Используйте гендерно-нейтральный язык в общении и рассмотрите возможность напрямую спросить пользователя, а не предполагать.

Могу ли я предсказать пол по прозвищам или сокращенным именам?

Да, если псевдоним достаточно распространен и может появиться в наборе данных. «Майк» вернется мужчиной, «Лиз» вернется женщиной. Необычные сокращения могут иметь меньшее количество образцов и менее надежные прогнозы.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.