API de genre pour les noms, e-mails et noms d’utilisateur

GenderAPI.io estime le genre probable à partir d’un nom, d’une adresse e-mail ou d’un nom d’utilisateur. V2 renvoie la prédiction, la confiance, la source et la consommation de crédits en JSON. Il s’agit d’estimations fondées sur des modèles de prénoms ; elles ne vérifient pas l’identité de genre déclarée par une personne.

Une requête individuelle consulte d’abord le jeu de données. Si aucune prédiction n’est trouvée, elle recourt à l’IA par défaut. Ce flux standard, recours à l’IA compris, consomme 1 crédit au total. Dans les requêtes par lots, l’IA est désactivée par défaut. Vous pouvez choisir le mode d’IA ou activer forceToGenderize pour analyser les pseudonymes.

Le champ confidence de V2 contient un score compris entre 0 et 1, ou null. Le champ confidence_kind distingue la fréquence observée dans le jeu de données de la confiance déclarée par le modèle ; ce score ne garantit pas l’exactitude. En l’absence de prédiction, la réponse contient gender: null et result_status: unknown.

Une requête V2 standard consomme 1 crédit, y compris le recours à l’IA et les résultats traités avec succès qui n’obtiennent pas de prédiction. Le mode d’IA always consomme 2 crédits. Avec forceToGenderize, une prédiction issue du jeu de données coûte 1 crédit ; si l’IA est utilisée, le coût total est de 2 crédits. Pour les lots, le coût est calculé par enregistrement.

Oui. V2 accepte jusqu’à 50 enregistrements par lot avec une clé API valide, ou jusqu’à 10 dans l’essai par IP. Une seule requête HTTP peut donc consommer plusieurs crédits. Pour des fichiers plus volumineux, vous pouvez aussi utiliser les outils Excel et CSV ou d’autres intégrations.

Sans clé API, la démo V2 utilise un essai de 10 crédits par période de 24 heures, partagés entre toutes les personnes qui utilisent la même adresse IP. Un compte gratuit dispose de 200 crédits par jour. Il s’agit de crédits, et non d’un nombre fixe de requêtes : les modes à 2 crédits épuisent le solde plus rapidement.

Oui. V1 et V2 partagent la même clé API et le même solde de compte. Les intégrations V1 existantes restent disponibles. Pour une nouvelle intégration, consultez la documentation V2 : ses endpoints, ses champs de réponse et son format d’erreur diffèrent de ceux de V1.