名前・メールアドレス・ユーザー名に対応したGender API

GenderAPI.ioは、名前、メールアドレス、ユーザー名から可能性の高い性別を推定します。V2は推定結果、信頼度、ソース、消費クレジットをJSONで返します。これらは名前に見られる傾向に基づく推定であり、本人が表明する性自認を確認するものではありません。

単一リクエストでは、まずデータセットを確認します。そこで推定が得られない場合は、デフォルトでAIを使用します。このデフォルトモードの費用は、AIの利用を含めて合計1クレジットです。バッチリクエストでは、AIはデフォルトで無効です。AIモードを選択したり、ニックネームを分析するためにforceToGenderizeを有効にしたりできます。

V2のconfidenceフィールドは0～1の値またはnullです。confidence_kindフィールドは、その値がデータセットで観測された頻度か、モデルが報告した値かを示します。信頼度は結果が正しいことを保証するものではありません。推定できない場合、レスポンスにはgender: nullとresult_status: unknownが含まれます。

標準的なV2リクエストは、AIを使用した場合や、正常に処理された結果に推定が含まれない場合も1クレジットです。AIモードalwaysは2クレジットです。forceToGenderizeでは、データセットからの推定は1クレジット、AIが必要な場合は合計2クレジットです。バッチリクエストでは項目ごとに課金されます。

はい。V2は、有効なAPIキーを使う場合はバッチあたり最大50項目、IPトライアルでは最大10項目を受け付けます。そのため、1回のHTTPリクエストで複数のクレジットを消費することがあります。大きなファイルは、Excel・CSVツールやその他の連携でも処理できます。

APIキーがない場合、V2のデモはIPトライアルを使用します。IPトライアルでは24時間ごとに10クレジットが付与され、同じIPアドレスを使うすべてのユーザーで共有されます。無料アカウントには1日200クレジットが付与されます。これはリクエスト数ではなくクレジットの上限であり、2クレジットのモードでは残高が早く減ります。

はい。V1とV2は同じAPIキーとアカウント残高を使用します。既存のV1連携は引き続き利用できます。新しい連携はV2ドキュメントに基づいて構築してください。V2はエンドポイント、レスポンスフィールド、エラー形式がV1と異なります。