您手上有一堆自拍照。也许您在测试一套护肤产品线,也许您是医美机构在收集治疗前照片,也许您只是想在不打开一堆 API 文档表格的情况下查看自己的肌肤评分。把每一张都放入完整的肌肤分析流程:上传、等待、阅读 JSON、重复,这样的下午并不好过。
好消息是:借助 YouCam AI 肌肤分析 API 和 Claude,您大约只需五分钟就能让自己的批量肌肤分析小工具跑起来。无需写代码,无需第三方上传网站。只需要一个提示词、一把免费的 API 密钥,以及一个可拖放的工具,就能在您自己的电脑本地运行。
三步即可。开始。
开始前您需要准备什么
- Claude Cowork,Anthropic 推出的代理式工作空间应用。工具将在这里构建。
- 一把 YouCam API 密钥,可在 API 控制台免费获取,包含初始额度,方便您立即运行首批分析。在此获取您的 API 密钥
- 几张清晰、正面的人脸照片,光线良好、不戴墨镜、前额可见。您手机里很可能已经有几张合适的照片。
这就是全部准备工作。现在开始搭建。
步骤 1:让 Claude 构建您的肌肤分析工具
打开 Claude Cowork,将下面的提示词粘贴进去。Claude 会在您的本地机器上构建一个小工具,即一个简单网页,您可以在其中拖入照片,并在每张照片上调用 YouCam 肌肤分析 引擎。
下面是提示词,请完整复制:
YouCam Skin Analysis (local tool) Batch AI skin analysis using Perfect Corp's YouCam API (skin-analysis). Runs entirely on your own machine, your API key never touches disk. Run it - macOS: double-click start-mac.command. - Windows: double-click start-windows.bat. First run installs dependencies automatically, then opens http://localhost:3940 in your browser. Use it 1. Paste your YouCam API key into the field at the top. 2. Add up to 10 photos (click the dropzone or drag and drop). 3. Pick a concern preset: Quick Check (wrinkle, pore, texture, acne, moisture) or Full SD Report (every standard-definition concern). Add an HD toggle for a sharper, higher-resolution single-photo report. 4. Click Analyze batch. Each photo gets its own card with a spinner, then a results panel showing a score for every concern plus a toggleable mask overlay so you can see exactly where each concern was detected. Up to 3 photos process at once, if one fails, the rest keep going. Notes - The browser only talks to the local server at localhost:3940, the local server proxies requests to yce-api-01.makeupar.com server-side (the API is server-to-server and blocks direct browser calls with CORS errors). - Your API key is held in a JS variable in the browser and sent per-request via the X-YCE-API-Key header. The server never writes it to disk or logs it. - SD and HD concerns cannot be mixed in a single request. The tool defaults to SD unless you flip the HD toggle for a given photo.
按回车,让 Claude 开始构建。您将得到一个可直接运行的工具。
在 Mac 上双击 start-mac.command,或在 Windows 上双击 start-windows.bat,浏览器中会打开一个简洁的分析页面,地址为 localhost:3940。
步骤 2:获取免费的 YouCam API 密钥
要让工具工作,只需要一件东西:YouCam API 密钥。前往 YouCam AI API 页面 注册,您会在控制台中获得一把密钥,同时附带初始额度,足以覆盖第一批扫描。请在控制台查看当前免费额度,足以在正式投入使用前充分测试工具。
从控制台复制您的密钥。Claude 构建的工具从不会将其保存在任何地方,只会保留在您当前的浏览器会话中。
步骤 3:上传、分析并查看结果
回到您的本地新工具中:
- 将 API 密钥粘贴到顶部的输入框。
- 添加照片,点击拖拽区域或直接拖入。
- 选择 Quick Check 或 Full SD Report,或为单张照片开启 HD 开关,获取更详细的高清扫描。
- 点击“Analyze batch”,您会看到每张照片生成自己的卡片和加载动画,几秒钟后会出现独立的评分面板,并带有可开关的遮罩叠加层,帮助您直观看到每项问题的检测位置。
每一项肌肤问题都会得到一个满分 100 的评分,以及一张可视化遮罩,精确标示出检测到问题的位置,例如眼周细纹、鼻部毛孔集中区域、双颊泛红部位。这与 YouCam 面向消费者的肌肤分析工具使用的是同一检测引擎,只是现在在您的浏览器标签页中,直接对您自己的照片进行分析。
为什么这比一次分析一张照片更好?
| 传统方式 | YouCam + Claude 的方式 |
|---|---|
| 将照片上传到随机的肌肤测试网站,只能期望其是正规的 | 在您自己的本地设备上运行 |
| 一张照片一份报告,需手动重复操作 | 批量拖入,一次点击,即可完成 |
| 没有可视化说明,只有一个模糊的分数 | 评分加上遮罩叠加,精确显示检测到问题的位置 |
| 您的照片会无限期存放在第三方服务器上 | 该工具绝不会将您的 API 密钥和照片写入磁盘 |
并且由于它基于真实的 YouCam API 构建,同一引擎可以远远超越个人工具的使用场景,扩展到产品页面、医美门诊问诊流程,或护肤应用的注册引导界面,帮助您在原型阶段之后快速升级到实际业务场景。
需要特别强调的是,这项API 技术目前仅对出海企业开放,专门服务于希望在海外扩展市场的品牌和零售商。如果您正在寻求提升海外用户体验、降低退货率并增加转化率的解决方案,虚拟试衣API 将是最具价值的数字化投资。
常见问题:YouCam AI 肌肤分析 + Claude
YouCam 肌肤分析 API 可以免费试用吗?
注册后您会获得初始额度,可在正式扩展使用前先测试真实分析结果。之后仅按实际调用量付费。
一次可以分析多少张照片?
该工具每批最多接收 10 张照片,并会同时处理最多 3 张。如果其中一张处理失败(例如光线不足或没有清晰的人脸),其他照片仍会继续处理。
我需要懂编程吗?
不需要。Claude Cowork 会根据上述提示构建完整工具。如果您会写代码,同一个 API 也可以直接集成到您自己的应用中,无需本地工具。
我的 API 密钥安全吗?
安全。工具完全在您的本地设备上运行。您的密钥保存在浏览器变量中,通过安全请求头随每次请求发送,且不会被写入磁盘或记录到日志。
Quick Check 与 Full SD Report 预设有何区别?
Quick Check 会快速检测少量常见问题,便于快速查看结果。Full SD Report 会运行所有标准清晰度的可用肌肤问题检测。两者均不能在同一请求中与高清(HD)检测项目组合使用,此限制来自底层 API,而非该工具本身。
如果某张照片的分析效果不好怎么办?
对于肌肤分析而言,光线和取景比几乎任何其他 YouCam 功能都更关键。正面、光线充足、额头清晰可见且未佩戴眼镜的照片能获得最可靠的评分。
准备好试用了吗?注册 YouCam AI API,获取您的密钥,只要一杯咖啡的时间,就能让属于您的肌肤分析工具上线运行。
* Youcam AI API目前仅适用于海外市场,国内产品敬请期待
原作者: 


