{"title":"皮肤分析 API / Skin Analysis API","version":"1.0.0","description":"使用 GPT-5 AI 分析面部照片并提供详细皮肤状况评估的 API 服务","baseUrl":"https://skin-care-scanner-paw9eojku-wills-projects-bfa42b65.vercel.app","endpoints":{"analyze":{"method":"POST","path":"/api/analyze","description":"分析面部自拍照并返回详细的皮肤状况评估报告","contentType":"multipart/form-data","parameters":{"image":{"type":"File","required":true,"description":"要分析的面部自拍照文件（支持 JPG、PNG、WebP 格式）","maxSize":"10MB","recommendations":"建议正面清晰照片，光线均匀，无美颜滤镜"},"language":{"type":"string","required":true,"description":"响应语言代码","enum":["zh-CN","en-US"],"examples":["zh-CN","en-US","zh","en"]}},"headers":{"X-API-Key":{"type":"string","required":true,"description":"API 密钥（从环境变量 API_KEY 获取）"}},"response":{"type":"object","properties":{"basic_info":{"type":"object","description":"基本皮肤信息","properties":{"skin_type":{"type":"string","description":"皮肤类型（油性/干性/混合性/中性/敏感性）"},"confidence_score":{"type":"number","description":"置信度分数（0-1）"},"summary":{"type":"string","description":"整体概述"}}},"overall_score":{"type":"object","description":"整体评分","properties":{"score":{"type":"number","description":"总分（0-100）"},"level":{"type":"string","description":"等级（优秀/良好/一般/较差）"},"note":{"type":"string","description":"评分说明"}}},"core_indicators":{"type":"object","description":"核心指标","properties":{"clear":{"type":"object","description":"清洁度指标（毛孔、痘痘等）"},"sensitive":{"type":"object","description":"敏感度指标（泛红、红血丝等）"},"fresh":{"type":"object","description":"年轻度指标（细纹、紧致度等）"}}},"skin_issues":{"type":"array","description":"识别的皮肤问题列表","items":{"type":"object","properties":{"issue":{"type":"string","description":"问题类型（Acne/Pores/Redness等）"},"severity":{"type":"string","description":"严重程度（轻度/中度/重度）"},"location":{"type":"string","description":"问题位置"}}}},"priority_recommendations":{"type":"array","description":"优先级建议（1-5条）","items":{"type":"object","properties":{"priority":{"type":"number","description":"优先级（1-5）"},"focus":{"type":"string","description":"关注重点"},"reason":{"type":"string","description":"原因说明"}}}},"actionable_tips":{"type":"object","description":"可执行的护肤建议","properties":{"skincare_steps":{"type":"array","description":"护肤步骤（3-6条）"},"do_and_dont":{"type":"array","description":"Do & Don't 建议（4-8条）"}}},"progress_tracking":{"type":"object","description":"进度跟踪","properties":{"current_scores":{"type":"object","description":"当前各项分数"}}}}},"example":{"request":"FormData with image file and language=zh-CN","response":{"basic_info":{"skin_type":"混合性","confidence_score":0.85,"summary":"你的皮肤整体属于混合性，T区偏油，U区略干"},"overall_score":{"score":73,"level":"良好","note":"整体肤况较好，主要问题集中在痘痘和敏感"},"core_indicators":{"clear":{"score":62,"level":"一般","note":"有一些黑头和痘痘，毛孔偏大"},"sensitive":{"score":70,"level":"中等","note":"脸颊有轻微泛红和红血丝"},"fresh":{"score":85,"level":"良好","note":"细纹较少，整体紧致度不错"}},"skin_issues":[{"issue":"Acne","severity":"中度","location":"额头、下巴"}],"priority_recommendations":[{"priority":1,"focus":"清洁与控油","reason":"黑头和痘痘明显，需要改善毛孔堵塞"}],"actionable_tips":{"skincare_steps":["使用温和洁面，每天早晚各一次","选择含有水杨酸/烟酰胺的精华"],"do_and_dont":["Do: 保持规律作息","Don't: 频繁去角质"]},"progress_tracking":{"current_scores":{"overall":73,"clear":62,"sensitive":70,"fresh":85}}}}},"health":{"method":"GET","path":"/api/health","description":"健康检查端点","response":{"type":"object","properties":{"status":{"type":"string","description":"服务状态"},"timestamp":{"type":"string","description":"当前时间戳"},"version":{"type":"string","description":"API 版本"},"service":{"type":"string","description":"服务名称"},"uptime":{"type":"number","description":"运行时间（秒）"},"environment":{"type":"string","description":"运行环境"}}}},"docs":{"method":"GET","path":"/api/docs","description":"API 文档端点（当前页面）","response":{"type":"object","description":"完整的 API 文档信息"}}},"usage":{"curl_example":"curl -X POST https://skin-care-scanner-paw9eojku-wills-projects-bfa42b65.vercel.app/api/analyze \\\n  -H \"X-API-Key: your_api_key_here\" \\\n  -F \"image=@/path/to/your/selfie.jpg\" \\\n  -F \"language=zh-CN\"","javascript_example":"\nconst formData = new FormData();\nformData.append('image', imageFile);\nformData.append('language', 'zh-CN');\n\nconst response = await fetch('https://skin-care-scanner-paw9eojku-wills-projects-bfa42b65.vercel.app/api/analyze', {\n  method: 'POST',\n  headers: {\n    'X-API-Key': 'your_api_key_here'\n  },\n  body: formData,\n});\n\nconst result = await response.json();\nconsole.log(result);\n      ","supported_languages":[{"code":"zh-CN","name":"简体中文","example":"language=zh-CN"},{"code":"en-US","name":"English","example":"language=en-US"}]},"notes":{"image_requirements":["建议使用正面清晰照片","光线均匀，避免强光或暗光","无美颜滤镜","图片大小不超过 10MB","支持 JPG、PNG、WebP 格式"],"security":["API Key 验证：请在请求头中包含 X-API-Key","所有图片仅用于即时分析，不会存储","分析结果不会被保存或用于其他目的"],"disclaimer":"本 API 提供的分析结果仅供参考，不可替代专业医生的诊断或治疗。如有严重皮肤问题，请咨询皮肤科医生。"}}