API Documentation

Intégrez l'IA de détection de type de visage à vos applications. API REST simple dotée de puissantes fonctionnalités d'analyse faciale.

L'API Face Type Detector vous permet d'accéder par programmation à tous nos outils d'analyse faciale basés sur l'IA. Créez des applications exceptionnelles grâce à la détection de la forme du visage, la comparaison avec des célébrités, l'analyse ethnique et bien plus encore. Essayez notre offre gratuite dès aujourd'hui !

Plans tarifaires

Gratuite
$0
Pour toujours
  • 100 appels API par mois
  • Accès à tous les outils d’IA
  • Temps de réponse standard
  • Soutien communautaire
  • Documentation de base
Enterprise
Coutume
Contactez-nous
  • Appels API illimités
  • Accès à tous les outils d’IA
  • Temps de réponse ultra-rapide
  • 24/7 support dédié
  • Aide à l'intégration personnalisée
  • Garantie SLA
  • Options en marque blanche

Commencer

Authentication

Toutes les requêtes API nécessitent une authentification par clé API. Veuillez inclure votre clé API dans l'en-tête de chaque requête. Vous pouvez obtenir votre clé API depuis le tableau de bord après votre inscription.

cURL curl -X POST https://api.facetypedetector.com/v1/analyze \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image": "base64_encoded_image"}'

Base URL

All API endpoints are relative to the base URL:

https://api.facetypedetector.com/v1

API Endpoints

POST /analyze/face-shape
Analyzes facial structure and returns the detected face shape type along with confidence scores and styling recommendations.
POST /analyze/celebrity
Compares the uploaded face against our celebrity database and returns the top matches with similarity percentages.
POST /analyze/ethnicity
Analyzes facial features to estimate ethnic background and heritage with confidence scores for each detected ethnicity.
POST /analyze/attractiveness
Evaluates facial symmetry, proportions, and features using golden ratio principles to provide an attractiveness score.
POST /analyze/skin
Detects skin type, tone, texture, and provides personalized skincare recommendations based on analysis results.

Request Parameters

Parameter Type Required Description
image chaîne Oui Données d'image encodées en Base64 ou URL de l'image
format chaîne Non Format de réponse : json ou xml (par défaut : json)
détaillée booléenne Non Inclure des données d'analyse détaillées(default: false)
URL_webhook chaîne No URL permettant de recevoir une notification webhook une fois le traitement terminé

Exemple de demande

JavaScript const response = await fetch('https://api.facetypedetector.com/v1/analyze/face-shape', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ image: 'data:image/jpeg;base64,/9j/4AAQSkZJRg...', detailed: true }) }); const result = await response.json(); console.log(result);

Example Response

JSON { "success": true, "data": { "face_shape": "Oval", "confidence": 0.94, "characteristics": { "face_length": "Balanced", "face_width": "Proportionate", "jawline": "Gently Rounded" }, "recommendations": { "hairstyles": ["Long layers", "Side-swept bangs", "Wavy texture"], "glasses": ["Oversized frames", "Cat-eye shapes", "Square frames"] } }, "processing_time_ms": 342 }

Gestion des erreurs

L'API utilise les codes d'état HTTP standard pour indiquer la réussite ou l'échec. Toutes les réponses d'erreur incluent un message descriptif et un code d'erreur à des fins de débogage.

Code d'état Type d'erreur Description
200 Succès Demande complétée avec succès
400 Mauvaise demande Paramètres invalides ou requête malformée
401 Non autorisé Clé API invalide ou manquante
429 Limite de taux Trop de requêtes, limite de débit dépassée
500 Erreur de serveur Erreur interne du serveur, veuillez réessayer

Limites de taux

Les limites de requêtes API sont appliquées en fonction de votre abonnement. L'offre gratuite autorise 100 requêtes par mois, l'offre Pro 10 000, et les offres Entreprise ont des limites personnalisées. Les en-têtes de limite de requêtes sont inclus dans chaque réponse.

X-RateLimit-Limit: 10000 X-RateLimit-Remaining: 9847 X-RateLimit-Reset: 1704067200

SDKs & Bibliothèques

Nous proposons des kits de développement logiciel (SDK) officiels pour les langages de programmation les plus courants afin de simplifier l'intégration. Téléchargez nos SDK depuis GitHub ou installez-les via un gestionnaire de paquets.

npm npm installer @facetypedetector/sdk
Python pip installer facetypedetector
Rubis gem installer facetypedetector

Soutien

Besoin d'aide pour intégrer notre API ? Notre équipe d'assistance est là pour vous. Les utilisateurs de la version gratuite bénéficient d'un accès à l'assistance communautaire, les utilisateurs Pro d'une assistance prioritaire par e-mail et les clients Entreprise d'une assistance dédiée 24/7 support dédié.

Pour toute question technique, veuillez consulter notre forum pour développeurs ou nous contacter directement à l'adresse suivante : api-support@facetypedetector.com