Eye Shape Detector

AI-powered API that instantly analyzes facial images to classify eye shapes (almond, round, hooded, etc.) with precision metrics for beauty, healthcare, and AR applications.

原始信息汇总

Eye Shape Detector API 数据集概述

基本信息

• API版本：v1
• 基础URL：https://eye-shape-detector.p.rapidapi.com
• 协议：HTTPS
• 数据格式：JSON

功能描述

该API利用计算机视觉技术对JPEG、PNG或WEBP格式的图像进行实时高精度眼部特征分析，能够准确识别并将眼形分类为六种不同类型（杏仁形、圆形、内双眼皮、单眼皮、下垂形、上扬形），同时提取详细的形态学指标，如宽高比、眼皮褶皱可见度和外眼角角度。

主要端点

眼形检测分析

• 方法：POST
• 路径：/api/v1/detection-result
• 功能：分析上传图像中的眼形，返回详细分析结果和个性化推荐。

请求头

参数	类型	必选	描述
Authorization	string	是	Bearer token认证
Content-Type	string	是	固定值：application/json
x-rapidapi-host	string	是	固定值：eye-shape-detector.p.rapidapi.com
x-rapidapi-key	string	是	用户的RapidAPI密钥

请求体

json { "image": "base64_encoded_image_data" }

参数	类型	必选	描述
image	string	是	Base64编码的图像数据，支持JPEG、PNG、WEBP格式

响应格式

成功响应（200 OK）

json { "success": true, "results": { "primaryShape": "Almond Eyes 72.2%", "shapes": { "roundEyes": "53.9%", "upturnedEyes": "28.1%", "downturnedEyes": "11.5%", "wideSetEyes": "4.2%", "closeSetEyes": "1.9%", "deepSetEyes": "0.3%", "protrudingEyes": "0.1%" }, "description": "详细描述眼形特征", "recommendations": { "eyeliner": ["眼线技巧推荐"], "eyewear": ["眼镜框推荐"], "makeup": ["化妆技巧推荐"], "eyebrows": ["眉形推荐"], "eyeshadow": ["眼影技巧推荐"], "general": ["一般造型推荐"] } }, "channel": "channel1", "channelName": "channel1", "timestamp": "2025-07-12T10:52:29.234Z" }

眼形类型

眼形类型	描述
almondEyes	杏仁眼 - 椭圆形，内外眼角尖细
roundEyes	圆眼 - 圆形，白色部分更明显
upturnedEyes	上扬眼 - 外眼角向上倾斜
downturnedEyes	下垂眼 - 外眼角向下倾斜
wideSetEyes	宽距眼 - 两眼间距较远
closeSetEyes	窄距眼 - 两眼间距较近
deepSetEyes	深陷眼 - 眼睛深陷于眼窝中
protrudingEyes	凸出眼 - 眼睛从眼窝中凸出

使用限制

• 文件大小：最大10MB
• 支持格式：JPEG、PNG、WEBP
• 请求超时：60秒
• 图像要求：清晰的面部照片，眼睛可见

应用场景

• 美容应用：基于眼形推荐眼妆技巧
• 眼镜店：推荐合适的眼镜框款式
• 美容院：提供个性化美容建议
• 时尚应用：整体造型和服装推荐
• 个人护理：了解个人眼形特征

搜集汇总

背景与挑战

背景概述

该数据集是一个基于计算机视觉的眼部形状检测API，能够实时分析JPEG、PNG或WEBP图像，将眼部形状精确分类为杏仁形、圆形、下垂形等多种类型，并提取形态学指标。它适用于美容科技平台提供个性化化妆建议、医疗保健系统进行初步评估以及AR/VR应用，具备亚秒级响应时间和企业级可靠性。