POST AI agent ready /v1/gender/estimate

性別検出 API - 名から性別を予測します

公共の人口統計データに基づいてトレーニングされた統計モデルを使用して、名に関連付けられた性別を予測します。「男性」または「女性」を確率スコア (0 ～ 1) とサンプル数とともに返します。必要に応じて、地域固有の精度を得るために結果を国ごとに絞り込みます。

Endpoint

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 に名はあるが性別フィールドがない場合、このエンドポイントを使用して性別を予測し、適切な挨拶文 (「Dear Mr. Smith」または「Dear Ms. Johnson」) を生成します。エラーを避けるために、確率が 0.90 を超える予測のみを適用します。

情報が直接収集されなかった場合でも、性別を予測してアンケート回答やユーザー分析を充実させます。このデータを使用して、ユーザーベース全体の性別分布、製品の使用パターン、または A/B テストの結果に関する集計レポートを作成します。

アカウント所有者の名から性別を予測して、デフォルトの製品カテゴリをパーソナライズします。ユーザーが自分の好みを更新する簡単なオプションを提供しながら、予測された性別に合わせて衣類、アクセサリー、ギフトの推奨事項を表示します。

性別フィールドはどのような値を返しますか?

性別フィールドは、その名前の統計的多数派に基づいて「男性」または「女性」を返します。確率がほぼ等しい名前 (例: 「Alex」) の場合、応答はわずかに多数を反映し、確率は 0.50 に近くなります。

確率スコアは何を意味しますか?

確率は、信頼度を示す 0 から 1 までの値です。スコア 0.98 は、データセット内のその名前を持つ人の 98% が予測された性別と同一であることを意味します。 0.60 未満のスコアは、名前が非常にユニセックスであることを示します。

country_id は結果に影響しますか?

はい。名前によっては、国によって性別の関連付けが異なる場合があります。「アンドレア」は英語圏では主に女性ですが、イタリアでは男性です。 country_id を指定すると、より正確な地域予測が得られます。

確率の低い予測にはどう対処すればよいでしょうか?

確率が 0.70 未満の予測の場合、名前は性別があいまいなものとして扱います。コミュニケーションでは性別に依存しない言葉を使用し、思い込みではなくユーザーに直接質問することを検討してください。

ニックネームや略称の性別を予測できますか?

はい、ニックネームがデータセットに表示されるほど一般的な場合は可能です。「マイク」は男性に戻り、「リズ」は女性に戻ります。一般的ではない略語はサンプル数が少なく、予測の信頼性が低い可能性があります。

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