{"items":[{"type":"link","label":"AI 肤质分析 V2.1","link":"/zh-cn/reference/ai_skin_analysis","routeSlug":"/zh-cn/reference/ai_skin_analysis","content":{"contentType":"overview","meta":{"name":"AI 肤质分析 V2.1"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"ai_skin_analysis.json","url":"/_bundle/@l10n/zh-CN/reference/ai_skin_analysis.json?download"},{"kind":"download","label":"ai_skin_analysis.yaml","url":"/_bundle/@l10n/zh-CN/reference/ai_skin_analysis.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"YouCamOnlineEditor_API@perfectcorp.com","label":"YouCamOnlineEditor_API@perfectcorp.com","withCopyButton":true,"copyContent":"YouCamOnlineEditor_API@perfectcorp.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Privacy policy","url":"https://www.makeupar.com/perfectbeauty/youcam/privacy-policy-api"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.makeupar.com/perfectbeauty/youcam/terms-of-service-api"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://yce-api-01.makeupar.com"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"AI 肤质分析 V2.1","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[]}],"sectionId":"/"}],"sectionId":"/"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":1,"id":"section/概览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"概览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://d3ss46vukfdtpo.cloudfront.net/static/media/img_demostore_skincarelive_topbanner.0cffe3a7.jpg"},"children":[],"type":"image"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 V2.1"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 只凭一张正脸自拍，就能给出细致的皮肤洞察。它检测 16 项皮肤指标，包括皱纹、毛孔、色斑、泛红与肤质，并标出每一项皮肤问题出现在脸上的哪个位置；同时估算肌肤年龄，并算出一个整体肌肤状况评分。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"在 V2.1 中，您可以按需加上两个加购能力，让接入更完整："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高级测肤报告"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"：基于每位用户的检测结果，生成个性化、读起来轻松好懂的皮肤洞察。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品推荐"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"：把您商品目录里的商品对应用户的皮肤问题，做出有针对性的购物体验。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可以只用肤质分析，也可以搭配加购能力一起用。想对比这几种用法，请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"#section/overview/use-cases"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用场景"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]}],"sectionId":"/section/概览"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/接入指南"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接入指南"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析怎么拍照"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"正脸自拍一张"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"拍一张清楚的照片即可，正对镜头。头发散下放下来、垂到胸前，视线直视前方，做出正对镜头的角度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"也可以用 JS Camera Kit 拍照。同样把头发散下放下来、垂到胸前，不要扎起来。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口流程"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"测肤接口使用指引"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"本指引说明如何用 File 接口与 AI 任务接口上传图片并创建 AI 肤质分析。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 1 步：调整源图尺寸"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"把图片缩放到支持的尺寸范围——SD 为长边不超过 2560 像素、短边至少 480 像素；HD 为长边不超过 2560 像素、短边至少 1080 像素。详见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"#section/overview/File-Specs-and-Errors"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件规格与错误码"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 2 步：通过 File 接口上传文件元数据"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"图片要求"},"children":[],"type":"text"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"详见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"#section/overview/File-Specs-and-Errors"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件规格与错误码"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"发送 POST 请求初始化文件上传："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"curl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/file \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_size\": 547541\n      }\n    ]\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"curl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/file \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_size\": 547541\n      }\n    ]\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"重要"},"children":[],"type":"text"}],"type":"strong"}],"type":"em"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"：只调用 File 接口并不等于上传了文件。您必须"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"另外把文件上传到 File 接口响应中给出的那个 URL"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。那个 URL 就是您的上传目标，务必确认文件已成功传过去，再继续往下做。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"警告："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 请注意，若未把文件上传到 File 接口响应中给出的 URL，调用 AI 接口时会得到 500 Server Error / unknown_internal_error 或 404 Not Found 错误。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 3 步：取得上传 URL 与文件 ID"},"children":[],"type":"text"}],"type":"strong"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应中包含："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"requests.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" – 用于上传图片的预签名 URL。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" – 创建 AI 任务用的标识。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应示例："},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n        \"requests\": [\n          {\n            \"method\": \"PUT\",\n            \"url\": \"https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...\",\n            \"headers\": {\n              \"Content-Length\": \"547541\",\n              \"Content-Type\": \"image/png\"\n            }\n          }\n        ]\n      }\n    ]\n  }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n        \"requests\": [\n          {\n            \"method\": \"PUT\",\n            \"url\": \"https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...\",\n            \"headers\": {\n              \"Content-Length\": \"547541\",\n              \"Content-Type\": \"image/png\"\n            }\n          }\n        ]\n      }\n    ]\n  }\n}\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 4 步：把图片上传到预签名 URL"},"children":[],"type":"text"}],"type":"strong"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用提供的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"requests.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与请求头："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"curl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \\\n  --header 'Content-Type: image/png' \\\n  --header 'Content-Length: 547541' \\\n  --data-binary @'./skin_analysis_01_3dbd1b6683.png'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"curl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \\\n  --header 'Content-Type: image/png' \\\n  --header 'Content-Length: 547541' \\\n  --data-binary @'./skin_analysis_01_3dbd1b6683.png'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 5 步：创建 AI 任务"},"children":[],"type":"text"}],"type":"strong"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用第 2 步取得的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 创建 AI 肤质分析："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"curl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"src_file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n    \"dst_actions\": [\"wrinkle\", \"pore\", \"texture\", \"acne\"],\n    \"miniserver_args\": {\n      \"enable_mask_overlay\": true,\n      \"enable_dark_background_hd_pore\": true,\n      \"color_dark_background_hd_pore\": \"3D3D3D\",\n      \"opacity_dark_background_hd_pore\": 0.4\n      // Additional parameters omitted for brevity\n    },\n    \"format\": \"json\"\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"curl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"src_file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n    \"dst_actions\": [\"wrinkle\", \"pore\", \"texture\", \"acne\"],\n    \"miniserver_args\": {\n      \"enable_mask_overlay\": true,\n      \"enable_dark_background_hd_pore\": true,\n      \"color_dark_background_hd_pore\": \"3D3D3D\",\n      \"opacity_dark_background_hd_pore\": 0.4\n      // Additional parameters omitted for brevity\n    },\n    \"format\": \"json\"\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传完成后，就可以用文件 ID 或图片文件 URL 选择要分析的皮肤问题，详见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"#section/overview/Inputs-and-Outputs"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入与输出"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"随后用文件 ID 或图片文件 URL 调用 POST 'task/skin-analysis' 执行任务，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"并取得 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"text"}],"type":"strong"}],"type":"em"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"请注意，SD 与 HD 的皮肤问题参数"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不可"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"同时混用。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用已有的公开图片 URL"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"不必上传，发起 AI 任务时直接提供一个可公开访问的图片 URL 也可以。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应示例："},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"task_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT\"\n  }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"task_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT\"\n  }\n}\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 6 步：轮询任务状态"},"children":[],"type":"text"}],"type":"strong"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 取回任务结果："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"curl --request GET \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis/<YOUR_TASK_ID> \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"curl --request GET \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis/<YOUR_TASK_ID> \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用这个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"text"}],"type":"strong"}],"type":"em"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 轮询 GET 'task/skin-analysis' 监控任务状态，取得引擎当前的处理进度。引擎完成任务之前，状态会一直是 'running'，这一阶段不消耗点数。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"处理完成的结果保留 30 天。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不必用很短的间隔轮询。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"在保留期限内，轮询间隔可以自由安排。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"重要："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 由于执行时长没有保证，仍然需要轮询来查看任务状态。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"引擎成功处理您的输入文件、生成出图后，任务状态会变为 'success'。您会得到处理后图片的 URL 以及一个 dst_id，可直接串联下一个 AI 任务，不必把结果图重新上传。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"只有这种情况才会消耗点数。若引擎处理失败，任务状态会变为 'error'，不消耗点数。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"扣除点数时，系统优先扣除临近到期的点数；到期日相同时，优先扣除最早取得的点数。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"第 7 步：解读结果"},"children":[],"type":"text"}],"type":"strong"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应中包含："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ui_score"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" – 面向用户的分数。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"raw_score"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" – 原始分析分数。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"mask_urls"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" – 检测蒙版的 URL。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应示例："},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"results\": {\n      \"output\": [\n        {\n          \"type\": \"texture\",\n          \"ui_score\": 68,\n          \"raw_score\": 57.33,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...texture_output.jpg\"]\n        },\n        {\n          \"type\": \"pore\",\n          \"ui_score\": 92,\n          \"raw_score\": 95.34,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...pore_output.jpg\"]\n        }\n        // Additional results omitted for brevity\n      ]\n    },\n    \"task_status\": \"success\"\n  }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"results\": {\n      \"output\": [\n        {\n          \"type\": \"texture\",\n          \"ui_score\": 68,\n          \"raw_score\": 57.33,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...texture_output.jpg\"]\n        },\n        {\n          \"type\": \"pore\",\n          \"ui_score\": 92,\n          \"raw_score\": 95.34,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...pore_output.jpg\"]\n        }\n        // Additional results omitted for brevity\n      ]\n    },\n    \"task_status\": \"success\"\n  }\n}\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"排障指引"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"警告："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 请注意，SD 与 HD 的皮肤问题参数"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不可"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"同时混用。偏离这些规范会得到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"text"}],"type":"strong"}],"type":"em"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 错误。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若您混用 HD 与 SD 的皮肤问题参数，会得到如下错误："},"children":[],"type":"text"},{"$$mdtype":"Node","attributes":{"content":"{\n    \"status\": 400,\n    \"error\": \"cannot mix HD and SD dst_actions\",\n    \"error_code\": \"InvalidParameters\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n    \"status\": 400,\n    \"error\": \"cannot mix HD and SD dst_actions\",\n    \"error_code\": \"InvalidParameters\"\n}\n"},"children":[],"type":"text"}],"type":"fence"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若您拼错皮肤问题名称，或传入未知的皮肤问题，会得到如下错误："},"children":[],"type":"text"},{"$$mdtype":"Node","attributes":{"content":"{\n    \"status\": 400,\n    \"error\": \"Not available dst_action abc123\",\n    \"error_code\": \"InvalidParameters\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n    \"status\": 400,\n    \"error\": \"Not available dst_action abc123\",\n    \"error_code\": \"InvalidParameters\"\n}\n"},"children":[],"type":"text"}],"type":"fence"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"实际案例："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://plugins-media.makeupar.com/webconsultation/images/skincare-widget/img_webcm_skincare_service_survey_demo.jpg"},"children":[],"type":"image"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/skin_analysis_s5_poster_3_dt_85efe14952.png"},"children":[],"type":"image"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/Skincare_Pro_Medspa_Situation_Image_6aea6046f9.jpg"},"children":[],"type":"image"}],"type":"item"}],"type":"list"}]}],"sectionId":"/section/概览/接入指南"}],"sectionId":"/section/概览/接入指南"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/输入与输出"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入与输出"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入参数说明"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"控制 AI 肤质分析结果视觉呈现的方式有两种：要么生成多张图片，每项皮肤问题各出一张独立蒙版；要么用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"enable_mask_overlay"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 参数合成一张叠加图。系统默认输出多张蒙版，如何把每项皮肤问题的蒙版与图片混合，完全由您掌握。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"默认：enable_mask_overlay false"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/mask_overlay_false_1920_ea1cde0ead.png"},"children":[],"type":"image"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"把 enable_mask_overlay 设为 true"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/mask_overlay_1920_0fbb4786cc.png"},"children":[],"type":"image"}],"type":"paragraph"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输出 ZIP 数据结构说明"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"系统会提供一个 ZIP 文件，里面有一个 'skinanalysisResult' 文件夹。该文件夹中有一份 'score_info.json'，收录全部检测分数以及结果图片的对应关系。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"'score_info.json' 收录所有测肤检测结果，包含数值分数与对应输出蒙版文件的名称。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"PNG 文件是检测结果蒙版，可以叠加到您的原图上。直接用这些 PNG 的 alpha 值与原图混合，就能在原图上直接看到检测结果。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 ZIP 的文件结构"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD 护肤 ZIP"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"text"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_acne_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_age_spot_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_dark_circle_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_droopy_lower_eyelid_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_droopy_upper_eyelid_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_eye_bag_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_firmness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_moisture_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_oiliness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_radiance_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_redness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_texture_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore_output_all.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore_output_cheek.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore_output_forehead.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore_output_nose.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_all.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_crowfeet.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_forehead.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_glabellar.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_marionette.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_nasolabial.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle_output_periocular.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_tear_trough.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_skin_type.png"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD 护肤 ZIP"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"text"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"acne_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"age_spot_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dark_circle_v2_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"droopy_lower_eyelid_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"droopy_upper_eyelid_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"eye_bag_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"firmness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"moisture_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"oiliness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pore_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"radiance_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"redness_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"texture_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"wrinkle_output.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"tear_trough.png"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"skin_type.png"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"JSON 数据结构（score_info.json）"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"all\"：1 到 100 之间的浮点数，代表整体皮肤状况。分数越高，皮肤越健康、观感越好。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"skin_age\"：由 AI 推算的皮肤年龄，参照全年龄段人群分布得出。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每个类别包含："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"raw_score\"：1 到 100 之间的浮点数。分数越高，皮肤越健康、观感越好。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"ui_score\"：1 到 100 之间的整数。UI 分数在美容评估中主要起心理激励的作用。我们会调整原始分数，让结果更讨喜——考虑到消费者普遍希望关于自己皮肤状况的评价更正面。这样的校准能让用户更有信心，同时守住美容心理学的底层框架。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"output_mask_name\"：对应输出蒙版图片的文件名。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"类别与说明"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD 护肤："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_redness\"：衡量泛红严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_oiliness\"：判定出油程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_age_spot\"：检测老年斑与色素沉淀。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_radiance\"：评估光泽度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_moisture\"：评估皮肤水润度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_dark_circle\"：分析眼下黑眼圈情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_eye_bag\"：检测眼袋。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_droopy_upper_eyelid\"：衡量上眼皮下垂程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_droopy_lower_eyelid\"：衡量下眼皮下垂程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_firmness\"：评估皮肤紧实度与弹性。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_texture\"：子类别[whole]；分析整体皮肤纹理。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_acne\"：子类别[whole]；检测痘痘情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_pore\"：子类别[forehead, nose, cheek, whole]；检测并评估脸部各区域的毛孔。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_wrinkle\"：子类别[forehead, glabellar, crowfeet, periocular, nasolabial, marionette, whole]；衡量脸部各区域皱纹的严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_tear_trough\"：检测泪沟。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"hd_skin_type\"：子类别[whole, t_zone, u_zone]，评估肤质：Normal、Oily、Dry、Combination、Redness、Dry & Redness、Oily & Redness、Combination & Redness。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD 护肤："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"wrinkle\"：皱纹综合分析。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"droopy_upper_eyelid\"：衡量上眼皮下垂程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"droopy_lower_eyelid\"：衡量下眼皮下垂程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"firmness\"：评估皮肤紧实度与弹性。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"acne\"：评估痘痘情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"moisture\"：衡量皮肤水润度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"eye_bag\"：检测眼袋。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"dark_circle_v2\"：以另一套方法分析黑眼圈。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"age_spot\"：检测老年斑。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"radiance\"：评估皮肤明亮度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"redness\"：衡量泛红程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"oiliness\"：判定出油程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"pore\"：衡量毛孔明显程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"texture\"：分析整体皮肤纹理。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"tear_trough\"：检测泪沟。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"skin_type\"：子类别[whole, t_zone, u_zone]，评估肤质：Normal、Oily、Dry、Combination、Redness、Dry & Redness、Oily & Redness、Combination & Redness。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD 护肤的 score_info.json 示例"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n    \"hd_redness\": {\n        \"raw_score\": 72.011962890625,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"hd_redness_output.png\"\n    },\n    \"hd_oiliness\": {\n        \"raw_score\": 60.74365234375,\n        \"ui_score\": 72,\n        \"output_mask_name\": \"hd_oiliness_output.png\"\n    },\n    \"hd_age_spot\": {\n        \"raw_score\": 83.23274230957031,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"hd_age_spot_output.png\"\n    },\n    \"hd_radiance\": {\n        \"raw_score\": 76.57244205474854,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"hd_radiance_output.png\"\n    },\n    \"hd_moisture\": {\n        \"raw_score\": 48.694559931755066,\n        \"ui_score\": 70,\n        \"output_mask_name\": \"hd_moisture_output.png\"\n    },\n    \"hd_dark_circle\": {\n        \"raw_score\": 80.1993191242218,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"hd_dark_circle_output.png\"\n    },\n    \"hd_eye_bag\": {\n        \"raw_score\": 76.67280435562134,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"hd_eye_bag_output.png\"\n    },\n    \"hd_droopy_upper_eyelid\": {\n        \"raw_score\": 79.05348539352417,\n        \"ui_score\": 80,\n        \"output_mask_name\": \"hd_droopy_upper_eyelid_output.png\"\n    },\n    \"hd_droopy_lower_eyelid\": {\n        \"raw_score\": 79.97175455093384,\n        \"ui_score\": 81,\n        \"output_mask_name\": \"hd_droopy_lower_eyelid_output.png\"\n    },\n    \"hd_firmness\": {\n        \"raw_score\": 89.66898322105408,\n        \"ui_score\": 85,\n        \"output_mask_name\": \"hd_firmness_output.png\"\n    },\n    \"hd_texture\": {\n        \"whole\": {\n            \"raw_score\": 66.3921568627451,\n            \"ui_score\": 75,\n            \"output_mask_name\": \"hd_texture_output.png\"\n        }\n    },\n    \"hd_acne\": {\n        \"whole\": {\n            \"raw_score\": 59.92677688598633,\n            \"ui_score\": 76,\n            \"output_mask_name\": \"hd_acne_output.png\"\n        }\n    },\n    \"hd_pore\": {\n        \"forehead\": {\n            \"raw_score\": 79.59770965576172,\n            \"ui_score\": 80,\n            \"output_mask_name\": \"hd_pore_output_forehead.png\"\n        },\n        \"nose\": {\n            \"raw_score\": 29.139814376831055,\n            \"ui_score\": 58,\n            \"output_mask_name\": \"hd_pore_output_nose.png\"\n        },\n        \"cheek\": {\n            \"raw_score\": 44.11081314086914,\n            \"ui_score\": 65,\n            \"output_mask_name\": \"hd_pore_output_cheek.png\"\n        },\n        \"whole\": {\n            \"raw_score\": 49.23978805541992,\n            \"ui_score\": 67,\n            \"output_mask_name\": \"hd_pore_output_all.png\"\n        }\n    },\n    \"hd_wrinkle\": {\n        \"forehead\": {\n            \"raw_score\": 55.96956729888916,\n            \"ui_score\": 67,\n            \"output_mask_name\": \"hd_wrinkle_output_forehead.png\"\n        },\n        \"glabellar\": {\n            \"raw_score\": 76.7251181602478,\n            \"ui_score\": 75,\n            \"output_mask_name\": \"hd_wrinkle_output_glabellar.png\"\n        },\n        \"crowfeet\": {\n            \"raw_score\": 83.4361481666565,\n            \"ui_score\": 78,\n            \"output_mask_name\": \"hd_wrinkle_output_crowfeet.png\"\n        },\n        \"periocular\": {\n            \"raw_score\": 67.88706302642822,\n            \"ui_score\": 72,\n            \"output_mask_name\": \"hd_wrinkle_output_periocular.png\"\n        },\n        \"nasolabial\": {\n            \"raw_score\": 74.03312683105469,\n            \"ui_score\": 74,\n            \"output_mask_name\": \"hd_wrinkle_output_nasolabial.png\"\n        },\n        \"marionette\": {\n            \"raw_score\": 71.94477319717407,\n            \"ui_score\": 73,\n            \"output_mask_name\": \"hd_wrinkle_output_marionette.png\"\n        },\n        \"whole\": {\n            \"raw_score\": 49.64699745178223,\n            \"ui_score\": 65,\n            \"output_mask_name\": \"hd_wrinkle_output_all.png\"\n        }\n    },\n    \"all\": {\n        \"score\": 75.75757575757575\n    },\n    \"skin_age\": 37\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n    \"hd_redness\": {\n        \"raw_score\": 72.011962890625,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"hd_redness_output.png\"\n    },\n    \"hd_oiliness\": {\n        \"raw_score\": 60.74365234375,\n        \"ui_score\": 72,\n        \"output_mask_name\": \"hd_oiliness_output.png\"\n    },\n    \"hd_age_spot\": {\n        \"raw_score\": 83.23274230957031,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"hd_age_spot_output.png\"\n    },\n    \"hd_radiance\": {\n        \"raw_score\": 76.57244205474854,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"hd_radiance_output.png\"\n    },\n    \"hd_moisture\": {\n        \"raw_score\": 48.694559931755066,\n        \"ui_score\": 70,\n        \"output_mask_name\": \"hd_moisture_output.png\"\n    },\n    \"hd_dark_circle\": {\n        \"raw_score\": 80.1993191242218,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"hd_dark_circle_output.png\"\n    },\n    \"hd_eye_bag\": {\n        \"raw_score\": 76.67280435562134,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"hd_eye_bag_output.png\"\n    },\n    \"hd_droopy_upper_eyelid\": {\n        \"raw_score\": 79.05348539352417,\n        \"ui_score\": 80,\n        \"output_mask_name\": \"hd_droopy_upper_eyelid_output.png\"\n    },\n    \"hd_droopy_lower_eyelid\": {\n        \"raw_score\": 79.97175455093384,\n        \"ui_score\": 81,\n        \"output_mask_name\": \"hd_droopy_lower_eyelid_output.png\"\n    },\n    \"hd_firmness\": {\n        \"raw_score\": 89.66898322105408,\n        \"ui_score\": 85,\n        \"output_mask_name\": \"hd_firmness_output.png\"\n    },\n    \"hd_texture\": {\n        \"whole\": {\n            \"raw_score\": 66.3921568627451,\n            \"ui_score\": 75,\n            \"output_mask_name\": \"hd_texture_output.png\"\n        }\n    },\n    \"hd_acne\": {\n        \"whole\": {\n            \"raw_score\": 59.92677688598633,\n            \"ui_score\": 76,\n            \"output_mask_name\": \"hd_acne_output.png\"\n        }\n    },\n    \"hd_pore\": {\n        \"forehead\": {\n            \"raw_score\": 79.59770965576172,\n            \"ui_score\": 80,\n            \"output_mask_name\": \"hd_pore_output_forehead.png\"\n        },\n        \"nose\": {\n            \"raw_score\": 29.139814376831055,\n            \"ui_score\": 58,\n            \"output_mask_name\": \"hd_pore_output_nose.png\"\n        },\n        \"cheek\": {\n            \"raw_score\": 44.11081314086914,\n            \"ui_score\": 65,\n            \"output_mask_name\": \"hd_pore_output_cheek.png\"\n        },\n        \"whole\": {\n            \"raw_score\": 49.23978805541992,\n            \"ui_score\": 67,\n            \"output_mask_name\": \"hd_pore_output_all.png\"\n        }\n    },\n    \"hd_wrinkle\": {\n        \"forehead\": {\n            \"raw_score\": 55.96956729888916,\n            \"ui_score\": 67,\n            \"output_mask_name\": \"hd_wrinkle_output_forehead.png\"\n        },\n        \"glabellar\": {\n            \"raw_score\": 76.7251181602478,\n            \"ui_score\": 75,\n            \"output_mask_name\": \"hd_wrinkle_output_glabellar.png\"\n        },\n        \"crowfeet\": {\n            \"raw_score\": 83.4361481666565,\n            \"ui_score\": 78,\n            \"output_mask_name\": \"hd_wrinkle_output_crowfeet.png\"\n        },\n        \"periocular\": {\n            \"raw_score\": 67.88706302642822,\n            \"ui_score\": 72,\n            \"output_mask_name\": \"hd_wrinkle_output_periocular.png\"\n        },\n        \"nasolabial\": {\n            \"raw_score\": 74.03312683105469,\n            \"ui_score\": 74,\n            \"output_mask_name\": \"hd_wrinkle_output_nasolabial.png\"\n        },\n        \"marionette\": {\n            \"raw_score\": 71.94477319717407,\n            \"ui_score\": 73,\n            \"output_mask_name\": \"hd_wrinkle_output_marionette.png\"\n        },\n        \"whole\": {\n            \"raw_score\": 49.64699745178223,\n            \"ui_score\": 65,\n            \"output_mask_name\": \"hd_wrinkle_output_all.png\"\n        }\n    },\n    \"all\": {\n        \"score\": 75.75757575757575\n    },\n    \"skin_age\": 37\n}\n"},"children":[],"type":"text"}],"type":"fence"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD 护肤的 score_info.json 示例"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n    \"wrinkle\": {\n        \"raw_score\": 36.09360456466675,\n        \"ui_score\": 60,\n        \"output_mask_name\": \"wrinkle_output.png\"\n    },\n    \"droopy_upper_eyelid\": {\n        \"raw_score\": 79.05348539352417,\n        \"ui_score\": 80,\n        \"output_mask_name\": \"droopy_upper_eyelid_output.png\"\n    },\n    \"droopy_lower_eyelid\": {\n        \"raw_score\": 79.97175455093384,\n        \"ui_score\": 81,\n        \"output_mask_name\": \"droopy_lower_eyelid_output.png\"\n    },\n    \"firmness\": {\n        \"raw_score\": 89.66898322105408,\n        \"ui_score\": 85,\n        \"output_mask_name\": \"firmness_output.png\"\n    },\n    \"acne\": {\n        \"raw_score\": 92.29713000000001,\n        \"ui_score\": 88,\n        \"output_mask_name\": \"acne_output.png\"\n    },\n    \"moisture\": {\n        \"raw_score\": 48.694559931755066,\n        \"ui_score\": 70,\n        \"output_mask_name\": \"moisture_output.png\"\n    },\n    \"eye_bag\": {\n        \"raw_score\": 76.67280435562134,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"eye_bag_output.png\"\n    },\n    \"dark_circle_v2\": {\n        \"raw_score\": 80.1993191242218,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"dark_circle_v2_output.png\"\n    },\n    \"age_spot\": {\n        \"raw_score\": 83.23274230957031,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"age_spot_output.png\"\n    },\n    \"radiance\": {\n        \"raw_score\": 76.57244205474854,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"radiance_output.png\"\n    },\n    \"redness\": {\n        \"raw_score\": 72.011962890625,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"redness_output.png\"\n    },\n    \"oiliness\": {\n        \"raw_score\": 60.74365234375,\n        \"ui_score\": 72,\n        \"output_mask_name\": \"oiliness_output.png\"\n    },\n    \"pore\": {\n        \"raw_score\": 88.38014125823975,\n        \"ui_score\": 84,\n        \"output_mask_name\": \"pore_output.png\"\n    },\n    \"texture\": {\n        \"raw_score\": 80.09742498397827,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"texture_output.png\"\n    },\n    \"all\": {\n        \"score\": 75.75757575757575\n    },\n    \"skin_age\": 37\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n    \"wrinkle\": {\n        \"raw_score\": 36.09360456466675,\n        \"ui_score\": 60,\n        \"output_mask_name\": \"wrinkle_output.png\"\n    },\n    \"droopy_upper_eyelid\": {\n        \"raw_score\": 79.05348539352417,\n        \"ui_score\": 80,\n        \"output_mask_name\": \"droopy_upper_eyelid_output.png\"\n    },\n    \"droopy_lower_eyelid\": {\n        \"raw_score\": 79.97175455093384,\n        \"ui_score\": 81,\n        \"output_mask_name\": \"droopy_lower_eyelid_output.png\"\n    },\n    \"firmness\": {\n        \"raw_score\": 89.66898322105408,\n        \"ui_score\": 85,\n        \"output_mask_name\": \"firmness_output.png\"\n    },\n    \"acne\": {\n        \"raw_score\": 92.29713000000001,\n        \"ui_score\": 88,\n        \"output_mask_name\": \"acne_output.png\"\n    },\n    \"moisture\": {\n        \"raw_score\": 48.694559931755066,\n        \"ui_score\": 70,\n        \"output_mask_name\": \"moisture_output.png\"\n    },\n    \"eye_bag\": {\n        \"raw_score\": 76.67280435562134,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"eye_bag_output.png\"\n    },\n    \"dark_circle_v2\": {\n        \"raw_score\": 80.1993191242218,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"dark_circle_v2_output.png\"\n    },\n    \"age_spot\": {\n        \"raw_score\": 83.23274230957031,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"age_spot_output.png\"\n    },\n    \"radiance\": {\n        \"raw_score\": 76.57244205474854,\n        \"ui_score\": 79,\n        \"output_mask_name\": \"radiance_output.png\"\n    },\n    \"redness\": {\n        \"raw_score\": 72.011962890625,\n        \"ui_score\": 77,\n        \"output_mask_name\": \"redness_output.png\"\n    },\n    \"oiliness\": {\n        \"raw_score\": 60.74365234375,\n        \"ui_score\": 72,\n        \"output_mask_name\": \"oiliness_output.png\"\n    },\n    \"pore\": {\n        \"raw_score\": 88.38014125823975,\n        \"ui_score\": 84,\n        \"output_mask_name\": \"pore_output.png\"\n    },\n    \"texture\": {\n        \"raw_score\": 80.09742498397827,\n        \"ui_score\": 76,\n        \"output_mask_name\": \"texture_output.png\"\n    },\n    \"all\": {\n        \"score\": 75.75757575757575\n    },\n    \"skin_age\": 37\n}\n"},"children":[],"type":"text"}],"type":"fence"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"}]}],"sectionId":"/section/概览/输入与输出"}],"sectionId":"/section/概览/输入与输出"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/文件规格与错误码"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件规格与错误码"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"支持的格式与尺寸"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 功能"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"支持尺寸"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"支持文件大小"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"支持格式"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD 护肤"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"短边长度至少 480 像素。 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 长边不限制；但超过 2560 像素时，系统会自动缩放到 2560 像素。"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"< 10MB"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"jpg/jpeg/png"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD 护肤"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"短边长度至少 1080 像素。 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 长边不限制；但超过 2560 像素时，会自动缩放到 2560 像素。"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"< 10MB"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"jpg/jpeg/png"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"警告："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 接口会自动把图片缩放到最大 2560 像素，但请自行确保所有人脸清楚合焦、画质够高、光线均匀、人脸足够大且正对相机。拍摄 HD 或 SD 护肤图片、准备跑 AI 肤质分析之前，务必避开运动模糊与遮挡。为获得最佳效果，强烈建议采用竖幅（肖像）比例，不要横幅。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"拍摄建议："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_AI%20Skin%20Analysis_camera_f93315b088.png"},"children":[],"type":"image"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"开始测肤前的准备说明"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"摘下眼镜，确认刘海没有遮住额头"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"确保您处在光线充足的环境中"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"卸妆后再测，结果更准"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"直视镜头，把脸保持在画面中央"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"照片要求"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"我们会检查图片质量，确认它适合跑 AI 肤质分析。请确保脸部约占图片宽度的 60–80%，没有任何叠加物或遮挡。光线要明亮且分布均匀，避免过曝与高光溢出。姿态须正对镜头、自然放松，嘴巴闭合、眼睛睁开。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请完整露出额头，把刘海往后梳或把头发扎起来，保证质量最佳。建议摘下眼镜，AI 肤质分析表现更好，这一项不是强制要求。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"警告："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 脸部宽度需大于图片宽度的 60%。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"alt":"","src":"https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_AI%20Skin%20Analysis_error_src_face_too_small_cr_725792a7fb.png"},"children":[],"type":"image"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_below_min_image_size"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片分辨率过小"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_exceed_max_image_size"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片分辨率过大"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_src_face_too_small"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传图片中的脸部区域太小。脸部宽度需大于图片宽度的 60%。"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_src_face_out_of_bound"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传图片中的脸部区域超出画面边界"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_lighting_dark"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传图片的光线太暗"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"运行环境与依赖"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"示例代码语言 / 工具"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"建议运行时版本"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"cURL"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"- bash >= 3.2"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"   - curl >= 7.58 (modern TLS/HTTP support)"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"   - jq >= 1.6 (robust JSON parsing)"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Node.js (JavaScript)"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Node >= 18 (for global fetch)"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"JavaScript"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"- Chrome / Edge >= 80"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"   - Firefox >= 74"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"   - Safari >= 13.1"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"PHP"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Python"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Python >= 3.10 (for f-strings), requests >= 2.20.0"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Java"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Java 11+ (for HttpClient), Jackson Databind >= 2.12.0"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"sectionId":"/section/概览/文件规格与错误码"}],"sectionId":"/section/概览/文件规格与错误码"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/点数消耗"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"点数消耗"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 V2.1"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 功能"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"加购高级测肤报告"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"加购商品推荐"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析 1~4 项皮肤问题"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"9"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"12"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+15 点"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+10 点"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析 5~8 项皮肤问题"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"12"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"16"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+25 点"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+15 点"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析 9~12 项皮肤问题"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"14"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"20"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+35 点"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+20 点"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析 13~16 项皮肤问题"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"16"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"22"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+40 点"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"+25 点"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"sectionId":"/section/概览/点数消耗"}],"sectionId":"/section/概览/点数消耗"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/js-camera-kit"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"JS Camera Kit"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"file":"@l10n/zh-CN/_partials/js-camera-kit.md","variables":{"$$apiDocsHeadingScope":{"operationId":"section/概览"}}},"children":[],"type":"tag","tag":"partial"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"sectionId":"/section/概览/js-camera-kit"}],"sectionId":"/section/概览/js-camera-kit"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/mobile-camera-kit"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Mobile Camera Kit"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{"file":"@l10n/zh-CN/_partials/mobile-camera-kit.md","variables":{"$$apiDocsHeadingScope":{"operationId":"section/概览"}}},"children":[],"type":"tag","tag":"partial"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"sectionId":"/section/概览/mobile-camera-kit"}],"sectionId":"/section/概览/mobile-camera-kit"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"section/概览/使用场景"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用场景"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Base URL："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"https://yce-api-01.makeupar.com"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析接口："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"POST /s2s/v2.1/task/skin-analysis"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"鉴权："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization: Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" —— 请注意 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Bearer"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与密钥之间只有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"export API_KEY=\"your-api-key\"\nexport BASE_URL=\"https://yce-api-01.makeupar.com\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"export API_KEY=\"your-api-key\"\nexport BASE_URL=\"https://yce-api-01.makeupar.com\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每种使用场景各自对应一个接口，按您需要哪些加购能力来选择："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"模式"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里能拿到什么"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"/reference/ai_skin_analysis/standard-analysis/endpoint-overview"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析（标准）"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不传"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不传"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"各检测维度的皮肤问题评分"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"/reference/ai_skin_analysis/analysis-+-advanced-report/endpoint-overview"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 + 高级测肤报告"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传入"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不传"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"评分，外加一份讲成因与护理建议的个性化报告"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"/reference/ai_skin_analysis/analysis-+-product-recommendation/endpoint-overview"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 + 商品推荐"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不传"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传入"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"评分，外加从您的商品目录里匹配出的商品"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"href":"/reference/ai_skin_analysis/analysis-+-report-+-recommendation/endpoint-overview"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析 + 高级测肤报告 + 商品推荐"},"children":[],"type":"text"}],"type":"link"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传入"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传入"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"一次调用同时拿到评分、报告与商品匹配结果"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明："},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 带加购能力的模式会在基础点数之外产生额外的点数消耗。详情请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"/reference/ai_skin_analysis/section/overview/unit-consumption"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"点数消耗"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"blockquote"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"sectionId":"/section/概览/使用场景"}],"sectionId":"/section/概览/使用场景"}]}]}},{"type":"group","label":"概览","link":"/zh-cn/reference/ai_skin_analysis/section/概览","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览","items":[{"type":"link","label":"接入指南","link":"/zh-cn/reference/ai_skin_analysis/section/概览/接入指南","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/接入指南","content":null},{"type":"link","label":"输入与输出","link":"/zh-cn/reference/ai_skin_analysis/section/概览/输入与输出","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/输入与输出","content":null},{"type":"link","label":"文件规格与错误码","link":"/zh-cn/reference/ai_skin_analysis/section/概览/文件规格与错误码","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/文件规格与错误码","content":null},{"type":"link","label":"点数消耗","link":"/zh-cn/reference/ai_skin_analysis/section/概览/点数消耗","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/点数消耗","content":null},{"type":"link","label":"JS Camera Kit","link":"/zh-cn/reference/ai_skin_analysis/section/概览/js-camera-kit","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/js-camera-kit","content":null},{"type":"link","label":"Mobile Camera Kit","link":"/zh-cn/reference/ai_skin_analysis/section/概览/mobile-camera-kit","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/mobile-camera-kit","content":null},{"type":"link","label":"使用场景","link":"/zh-cn/reference/ai_skin_analysis/section/概览/使用场景","routeSlug":"/zh-cn/reference/ai_skin_analysis/section/概览/使用场景","content":null}],"content":null},{"type":"group","label":"Standard Analysis","link":"/zh-cn/reference/ai_skin_analysis/standard-analysis","routeSlug":"/zh-cn/reference/ai_skin_analysis/standard-analysis","items":[{"type":"link","label":"接口总览","link":"/zh-cn/reference/ai_skin_analysis/standard-analysis/接口总览","routeSlug":"/zh-cn/reference/ai_skin_analysis/standard-analysis/接口总览","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"接口总览"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"standard-analysis/接口总览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口总览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"这是什么。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 标准 AI 肤质分析针对您选定的皮肤问题给出客观、量化的评分，并附上精准的检测蒙版与热力图。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"依托先进的 AI 深度学习与面部区域分割技术，Perfect Corp AI 肤质分析无需物理接触，即可从数字图片中评估可见的皮肤状况。方案会输出量化评分、检测蒙版、热力图与 AR 叠加效果，用个性化的护肤洞察帮助用户更了解自己的皮肤，并据此定制属于每个人的护肤流程。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"支持的皮肤问题包括："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"皱纹"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"水润度"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"紧致度"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上睑下垂"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"下睑下垂"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"毛孔"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"纹理"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"痘痘"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"出油"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"色斑"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"黑眼圈"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"光泽度"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"泛红"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"眼袋"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"泪沟"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"此外还会输出肤质、预估肌肤年龄与整体肌肤状况评分。所有结果都是基于图片的指标，仅供护肤参考，不构成临床测量、诊断或医学评估。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"创建 AI 任务"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{"content":"# Standard Skin Analysis V2.1\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\"hd_wrinkle\", \"hd_pore\", \"hd_texture\", \"hd_acne\"],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Standard Skin Analysis V2.1\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\"hd_wrinkle\", \"hd_pore\", \"hd_texture\", \"hd_acne\"],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"轮询获取报告与推荐"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每次调用都会立刻返回一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskResponseV2"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用返回的 id 轮询任务即可；报告与推荐结果都在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis/$TASK_ID\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis/$TASK_ID\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_status"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会从 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"running"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 走到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" | "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 是一条有效期为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2 小时"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"的下载链接，ZIP 里有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，内含 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 和所有检测结果图片。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.output"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会把评分直接写在响应体里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求字段速查"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" / "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_url"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是（二选一）"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片，规则同 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskV2"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是"},"children":[],"type":"text"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么全是 HD 项目，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"全是 SD 项目——不能混用"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"format"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"（默认）| "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——两者的响应结构不同"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pf_camera_kit"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"V2.1 新增；脸部轮廓与五官定位"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"miniserver_args"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"蒙版叠加，以及 HD 毛孔／皱纹的底图控制项"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出报告；"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"{}"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 表示全部用默认值；不传就没有报告"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出推荐；需要 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分辨率。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 所有输出图片的长边都限制在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2560 px"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 以内，输入图片会自动缩放。若 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"enable_mask_overlay"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"false"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，您拿到的是原始蒙版 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":".png"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，需要自行合成——请先确认输入图片的分辨率，长边超过 2560 px 时，按 2560 px 来规划您的显示尺寸。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"panels":[]}]}},{"label":"执行 AI 肤质分析（V2.1） 任务。","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis/post","routeSlug":"/zh-cn/reference/ai_skin_analysis/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis/post","metadata":{"seo":{"title":"执行 AI 肤质分析（V2.1） 任务。","description":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 success 或 error 通知后，用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"执行 AI 肤质分析（V2.1） 任务。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"执行 AI 肤质分析（V2.1） 任务。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 通知后，用收到的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 查询任务结果。配置与校验的细节请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"/develop/webhook"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Webhook 接入指南"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若功能不支持 Webhook，或您的接入方式用不了 Webhook，就请实现轮询。提交 AI 任务后，按固定间隔（例如每 10 秒）轮询状态接口，直到任务状态变为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_0"}},"schemaId":"schema_0","pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/s2s/v2.1/task/skin-analysis","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_0"}},"responseCodes":["200","400","401","429"],"pointer":"/s2s/v2.1/task/skin-analysis","href":"standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis/post","summary":"执行 AI 肤质分析（V2.1） 任务。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"schemaId":"schema_0","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_0"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析任务执行成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}},"schemaId":"components/schemas/BasicRunTaskResponseV2"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行失败。除常见情况外，请求若带了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，会返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，且不扣点数。需要这两项时，请改用 skin-analysis-report、skin-analysis-recommendation 或 skin-analysis-report-recommendation 接口。"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported"]}},"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported"]},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"429","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求过多"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}},"schemaId":"schema_3"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BasicRunTaskResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}}},{"code":"400","schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported"]}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"429","schemaId":"schema_3","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis/post"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis"},{"label":"查询 AI 肤质分析（V2.1） 任务的状态。","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get","routeSlug":"/zh-cn/reference/ai_skin_analysis/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get","metadata":{"seo":{"title":"查询 AI 肤质分析（V2.1） 任务的状态。","description":"查询 AI 肤质分析（V2.1） 任务的状态。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"查询 AI 肤质分析（V2.1） 任务的状态。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询 AI 肤质分析（V2.1） 任务的状态。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"task_id","in":"path","schemaId":"schema_4","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要查询的任务 ID"},"children":[],"type":"text"}],"type":"paragraph"}],"required":true}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.1/task/skin-analysis/{task_id}","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[{"name":"task_id","in":"path","required":true,"example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe","schemaId":"schema_4"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/s2s/v2.1/task/skin-analysis/{task_id}","href":"standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get","summary":"查询 AI 肤质分析（V2.1） 任务的状态。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析任务状态查询成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}},"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务 ID 无效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}},"schemaId":"schema_6"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"500","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行超时"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}},"schemaId":"schema_7"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}}},{"code":"400","schemaId":"schema_6","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"500","schemaId":"schema_7","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis/{task_id}"}],"content":{"contentType":"group","meta":{"name":"Standard Analysis"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Standard Analysis","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/s2s/v2.1/task/skin-analysis","summary":"执行 AI 肤质分析（V2.1） 任务。","prefix":{"name":"post","color":"post"},"badges":[],"link":"/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis/post","deprecated":false},{"title":"/s2s/v2.1/task/skin-analysis/{task_id}","summary":"查询 AI 肤质分析（V2.1） 任务的状态。","prefix":{"name":"get","color":"get"},"badges":[],"link":"/standard-analysis/paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get","deprecated":false}]}]}]}]}},{"type":"group","label":"Analysis + Advanced Report","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report","items":[{"type":"link","label":"接口总览","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/接口总览","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/接口总览","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"接口总览"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"analysis-+-advanced-report/接口总览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口总览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"这是什么。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 一份覆盖全维度的皮肤报告，用自然语言写成，由大语言模型生成——喂给模型的是您的"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"精准 AI 肤质分析结果"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，再加上一座"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"专业护肤参考数据库"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。模型不会凭空猜测您的皮肤：它解读的是实测出来的、量化的皮肤指标与真实的检测蒙版，把它们同专业护肤数据逐一对照，最后在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里返回一份完整的报告。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"报告的各个维度分别由哪些 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 支撑。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 您请求的分析项目决定了报告能有多丰富。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 是必填项，而且"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"同一个请求里 HD 与 SD 项目不能混用"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——只能选其中一类。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"报告维度"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"V2.1 项目"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"返回的区域"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"脸部轮廓与五官定位"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pf_camera_kit: true"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"—"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"肤质"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_skin_type"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"whole"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"t_zone"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"u_zone"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"T 区与 U 区对比"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_skin_type"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"t_zone"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"u_zone"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"额头纹与眉间纹"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"forehead"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"glabellar"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"眼角纹与法令纹"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"crowfeet"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"nasolabial"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"毛孔分布"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"forehead"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"nose"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"cheek"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":", "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"whole"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"肌肤平滑度"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_texture"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"whole"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"参数"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"类型"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"默认值"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"language"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"string enum"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"enu"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"enu"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"cht"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"jpn"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"kor"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"fra"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"deu"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"esn"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ita"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ptb"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ind"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ara"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"tone"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"string enum"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"warm"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"warm"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" | "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"direct"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——两种语气都保持专业"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"country"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"string"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"—"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"为报告加入气候与季节背景"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"city"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"string"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"—"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"为报告加入气候与季节背景"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"\"advanced_report\": {}"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 就全部采用默认值；整个对象都不传，就没有报告。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"创建 AI 任务"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{"content":"# Skin Analysis with Advanced Skin Report\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\"],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"advanced_report\": {\n      \"language\": \"cht\",\n      \"tone\": \"direct\",\n      \"country\": \"Taiwan\",\n      \"city\": \"Taipei\"\n    }\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Skin Analysis with Advanced Skin Report\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\"],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"advanced_report\": {\n      \"language\": \"cht\",\n      \"tone\": \"direct\",\n      \"country\": \"Taiwan\",\n      \"city\": \"Taipei\"\n    }\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"content":"# Same call, every report default (enu / warm, no climate context)\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_id\": \"your-uploaded-file-id\",\n    \"dst_actions\": [\"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\"],\n    \"pf_camera_kit\": true,\n    \"advanced_report\": {}\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Same call, every report default (enu / warm, no climate context)\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_id\": \"your-uploaded-file-id\",\n    \"dst_actions\": [\"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\"],\n    \"pf_camera_kit\": true,\n    \"advanced_report\": {}\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"轮询获取报告与推荐"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每次调用都会立刻返回一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskResponseV2"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用返回的 id 轮询任务即可；报告与推荐结果都在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-report/$TASK_ID\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-report/$TASK_ID\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_status"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会从 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"running"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 走到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" | "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 是一条有效期为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2 小时"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"的下载链接，ZIP 里有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，内含 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 和所有检测结果图片。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.output"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会把评分直接写在响应体里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求字段速查"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" / "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_url"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是（二选一）"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片，规则见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskV2"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是"},"children":[],"type":"text"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么全是 HD 项目，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"全是 SD 项目——不能混用"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"format"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"（默认）| "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——两者的响应结构不同"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pf_camera_kit"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"V2.1 新增；脸部轮廓与五官定位"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"miniserver_args"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"蒙版叠加，以及 HD 毛孔／皱纹的底图控制项"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出报告；"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"{}"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 表示全部用默认值；不传就没有报告"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出推荐；需要 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分辨率。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 所有输出图片的长边都限制在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2560 px"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 以内，输入图片会自动缩放。若 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"enable_mask_overlay"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"false"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，您拿到的是原始蒙版 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":".png"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，需要自行合成——请先确认输入图片的分辨率，长边超过 2560 px 时，按 2560 px 来规划您的显示尺寸。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"panels":[]}]}},{"label":"执行「肤质分析 + 高级测肤报告」任务。","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post","metadata":{"seo":{"title":"执行「肤质分析 + 高级测肤报告」任务。","description":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 success 或 error 通知后，用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"执行「肤质分析 + 高级测肤报告」任务。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"执行「肤质分析 + 高级测肤报告」任务。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 通知后，用收到的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 查询任务结果。配置与校验的细节请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"/develop/webhook"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Webhook 接入指南"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若功能不支持 Webhook，或您的接入方式用不了 Webhook，就请实现轮询。提交 AI 任务后，按固定间隔（例如每 10 秒）轮询状态接口，直到任务状态变为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_8"}},"schemaId":"schema_8","pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/s2s/v2.1/task/skin-analysis-report","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_8"}},"responseCodes":["200","400","401","429"],"pointer":"/s2s/v2.1/task/skin-analysis-report","href":"analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post","summary":"执行「肤质分析 + 高级测肤报告」任务。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"schemaId":"schema_8","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_8"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"「肤质分析 + 高级测肤报告」任务执行成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}},"schemaId":"components/schemas/BasicRunTaskResponseV2"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行失败。除常见情况外，请求若带了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，会返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，且不扣点数。"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported"]}},"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported"]},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"429","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求过多"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}},"schemaId":"schema_3"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BasicRunTaskResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}}},{"code":"400","schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported"]}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"429","schemaId":"schema_3","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-report"},{"label":"查询「肤质分析 + 高级测肤报告」任务的状态。","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get","metadata":{"seo":{"title":"查询「肤质分析 + 高级测肤报告」任务的状态。","description":"查询「肤质分析 + 高级测肤报告」任务的状态。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"查询「肤质分析 + 高级测肤报告」任务的状态。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询「肤质分析 + 高级测肤报告」任务的状态。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"task_id","in":"path","schemaId":"schema_4","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要查询的任务 ID"},"children":[],"type":"text"}],"type":"paragraph"}],"required":true}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.1/task/skin-analysis-report/{task_id}","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[{"name":"task_id","in":"path","required":true,"example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe","schemaId":"schema_4"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/s2s/v2.1/task/skin-analysis-report/{task_id}","href":"analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get","summary":"查询「肤质分析 + 高级测肤报告」任务的状态。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析任务状态查询成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}},"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务 ID 无效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}},"schemaId":"schema_6"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"500","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行超时"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}},"schemaId":"schema_7"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}}},{"code":"400","schemaId":"schema_6","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"500","schemaId":"schema_7","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-report/{task_id}"}],"content":{"contentType":"group","meta":{"name":"Analysis + Advanced Report"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Analysis + Advanced Report","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/s2s/v2.1/task/skin-analysis-report","summary":"执行「肤质分析 + 高级测肤报告」任务。","prefix":{"name":"post","color":"post"},"badges":[],"link":"/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report/post","deprecated":false},{"title":"/s2s/v2.1/task/skin-analysis-report/{task_id}","summary":"查询「肤质分析 + 高级测肤报告」任务的状态。","prefix":{"name":"get","color":"get"},"badges":[],"link":"/analysis-+-advanced-report/paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get","deprecated":false}]}]}]}]}},{"type":"group","label":"Analysis + Product Recommendation","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation","items":[{"type":"link","label":"接口总览","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/接口总览","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/接口总览","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"接口总览"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"analysis-+-product-recommendation/接口总览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口总览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"这是什么。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 把您的商品目录交给一次精准的肤质分析来做匹配。上传您在售的护肤商品及其描述，调用时传入目录 id，接口就会在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里为每一项检测出的皮肤问题返回匹配度最高的商品。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"它与通用大模型推荐的区别在于输入。通用大模型靠概率和先验来推荐；Perfect AI 肤质分析先产出"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"科学、量化的皮肤指标与真实的检测蒙版"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，模型再把商品同实测出的皮肤状况一一对照——可靠、快速、说得清理由，而不是统计意义上的猜测。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"参数"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"类型"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"默认值"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"string"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是"},"children":[],"type":"text"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"—"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"来自「上传商品目录」。目录必须处于 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 状态，且属于您的账号。"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"top_n"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"integer"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"3"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每一"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"类"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"皮肤问题要推荐的商品数。最小 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"1"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"；不能超过目录的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"前置准备——上传您的商品目录"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品目录就是肤质分析做推荐时使用的那份商品清单。上传一次，记下它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，之后每次测肤都传入这个 id。目录归属于您的"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"账号"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，不属于某一个 API 密钥——账号下的每个密钥（包括项目密钥）看到的都是同一批目录，轮换密钥或删除密钥都不会影响它们。上传与存储目录完全免费。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录文件要求"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"项目"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"取值"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"格式"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"带表头行的 CSV"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"编码"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"UTF-8，带或不带 BOM 皆可（Excel 的\"CSV UTF-8\"会带上 BOM）"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件大小上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"5 MB"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SKU 数量上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"除文件大小外没有限制"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填栏位"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"、"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_name"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"、"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_description"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"其他栏位会被忽略，但仍计入 5 MB 的大小限制。取值中包含逗号或换行时，必须按标准 CSV 的规则加引号。每一行非空的数据行算作一个 SKU。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\nSKU-003,Barrier Repair Cream,\"Rich cream for dry, redness-prone skin.\"\n","language":"csv"},"children":[{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\nSKU-003,Barrier Repair Cream,\"Rich cream for dry, redness-prone skin.\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"content":"# Upload a catalog — validated in the same request\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/product-catalog\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -F \"file=@catalog.csv\" \\\n  -F \"name=Summer skincare\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Upload a catalog — validated in the same request\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/product-catalog\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -F \"file=@catalog.csv\" \\\n  -F \"name=Summer skincare\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件校验通过时，响应会给出 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"status: ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，并带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——请务必记下这个 id："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"catalog_id\": \"1662043585118399001\",\n    \"name\": \"Summer skincare\",\n    \"status\": \"ready\",\n    \"created_time\": 1760256000000,\n    \"sku_count\": 3\n  }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"catalog_id\": \"1662043585118399001\",\n    \"name\": \"Summer skincare\",\n    \"status\": \"ready\",\n    \"created_time\": 1760256000000,\n    \"sku_count\": 3\n  }\n}\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"content":"# List every catalog of your account, newest first (ready and failed alike)\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \"$BASE_URL/s2s/v2.1/product-catalog\"\n\n# Delete a catalog — immediate and permanent\ncurl -sS -X DELETE -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# List every catalog of your account, newest first (ready and failed alike)\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \"$BASE_URL/s2s/v2.1/product-catalog\"\n\n# Delete a catalog — immediate and permanent\ncurl -sS -X DELETE -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录状态与限制"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"状态"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"含义"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可用于测肤"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传并通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传，但文件未通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"未通过校验的上传会返回错误，同时"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"仍会被记录成一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，在「列出目录」里能看到它；错误响应体中不会带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。每个账号最多保留 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"10 个目录"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 合并计算——要先删掉一个，才能上传新的。更新目录的做法是上传一份新文件：每次上传都会产生一个新的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，旧目录在您删除之前一直可用，因此可以先确认新目录没问题再切换。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"创建 AI 任务"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{"content":"# Skin Analysis with Product Recommendation\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\n      \"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\",\n      \"hd_acne\", \"hd_redness\", \"hd_oiliness\", \"hd_moisture\",\n      \"hd_age_spot\", \"hd_radiance\", \"hd_dark_circle\"\n    ],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"product_recommendation\": {\n      \"catalog_id\": \"1662043585118399001\",\n      \"top_n\": 3\n    }\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Skin Analysis with Product Recommendation\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\n      \"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\",\n      \"hd_acne\", \"hd_redness\", \"hd_oiliness\", \"hd_moisture\",\n      \"hd_age_spot\", \"hd_radiance\", \"hd_dark_circle\"\n    ],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"product_recommendation\": {\n      \"catalog_id\": \"1662043585118399001\",\n      \"top_n\": 3\n    }\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"校验。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 下面这些情况都会返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"400"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 和 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error_code: InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，并且"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不会扣点数"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"触发原因"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 错误信息"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 却没有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id is required when product_recommendation is provided."},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录不存在、已被删除，或属于其他账号"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"No catalog was found with this catalog_id."},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录上传时未通过校验（"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"status: failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"）"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"This catalog failed validation when it was uploaded and can't be used. Upload the catalog again."},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不是大于等于 1 的整数"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"（常见的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 情形）"},"children":[],"type":"text"}],"type":"em"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 超过目录里的商品数"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.top_n can't be more than the 3 products in this catalog."},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"最后一条信息是动态生成的——它会报出目录真实的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请从「列出目录」读取 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，在客户端把 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 收敛到它的范围内。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"轮询获取报告与推荐"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每次调用都会立刻返回一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskResponseV2"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用返回的 id 轮询任务即可；报告与推荐结果都在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation/$TASK_ID\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-recommendation/$TASK_ID\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_status"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会从 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"running"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 走到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" | "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 是一条有效期为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2 小时"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"的下载链接，ZIP 里有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，内含 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 和所有检测结果图片。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.output"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会把评分直接写在响应体里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求字段速查"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" / "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_url"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是（二选一）"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片，规则见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskV2"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是"},"children":[],"type":"text"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么全是 HD 项目，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"全是 SD 项目——不能混用"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"format"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"（默认）| "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——两者的响应结构不同"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pf_camera_kit"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"V2.1 新增；脸部轮廓与五官定位"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"miniserver_args"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"蒙版叠加，以及 HD 毛孔／皱纹的底图控制项"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出报告；"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"{}"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 表示全部用默认值；不传就没有报告"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出推荐；需要 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分辨率。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 所有输出图片的长边都限制在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2560 px"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 以内，输入图片会自动缩放。若 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"enable_mask_overlay"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"false"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，您拿到的是原始蒙版 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":".png"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，需要自行合成——请先确认输入图片的分辨率，长边超过 2560 px 时，按 2560 px 来规划您的显示尺寸。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"panels":[]}]}},{"label":"执行「肤质分析 + 商品推荐」任务。","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post","metadata":{"seo":{"title":"执行「肤质分析 + 商品推荐」任务。","description":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 success 或 error 通知后，用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"执行「肤质分析 + 商品推荐」任务。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"执行「肤质分析 + 商品推荐」任务。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 通知后，用收到的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 查询任务结果。配置与校验的细节请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"/develop/webhook"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Webhook 接入指南"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若功能不支持 Webhook，或您的接入方式用不了 Webhook，就请实现轮询。提交 AI 任务后，按固定间隔（例如每 10 秒）轮询状态接口，直到任务状态变为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_9"}},"schemaId":"schema_9","pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/s2s/v2.1/task/skin-analysis-recommendation","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_9"}},"responseCodes":["200","400","401","429"],"pointer":"/s2s/v2.1/task/skin-analysis-recommendation","href":"analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post","summary":"执行「肤质分析 + 商品推荐」任务。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"schemaId":"schema_9","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_9"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"「肤质分析 + 商品推荐」任务执行成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}},"schemaId":"components/schemas/BasicRunTaskResponseV2"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行失败。除常见情况外，出现下列情况时请求会返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，且不扣点数："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"未提供 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"带了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"提供了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 却没有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不存在、已被删除，或属于其他账号"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 指向的目录在上传时未通过校验"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不是不小于 1 的整数"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 大于目录中的商品数量"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]}},"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"429","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求过多"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}},"schemaId":"schema_3"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BasicRunTaskResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}}},{"code":"400","schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"429","schemaId":"schema_3","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-recommendation"},{"label":"查询「肤质分析 + 商品推荐」任务的状态。","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get","metadata":{"seo":{"title":"查询「肤质分析 + 商品推荐」任务的状态。","description":"查询「肤质分析 + 商品推荐」任务的状态。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"查询「肤质分析 + 商品推荐」任务的状态。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询「肤质分析 + 商品推荐」任务的状态。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"task_id","in":"path","schemaId":"schema_4","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要查询的任务 ID"},"children":[],"type":"text"}],"type":"paragraph"}],"required":true}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.1/task/skin-analysis-recommendation/{task_id}","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[{"name":"task_id","in":"path","required":true,"example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe","schemaId":"schema_4"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/s2s/v2.1/task/skin-analysis-recommendation/{task_id}","href":"analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get","summary":"查询「肤质分析 + 商品推荐」任务的状态。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析任务状态查询成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}},"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务 ID 无效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}},"schemaId":"schema_6"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"500","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行超时"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}},"schemaId":"schema_7"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}}},{"code":"400","schemaId":"schema_6","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"500","schemaId":"schema_7","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-recommendation/{task_id}"}],"content":{"contentType":"group","meta":{"name":"Analysis + Product Recommendation"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Analysis + Product Recommendation","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/s2s/v2.1/task/skin-analysis-recommendation","summary":"执行「肤质分析 + 商品推荐」任务。","prefix":{"name":"post","color":"post"},"badges":[],"link":"/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post","deprecated":false},{"title":"/s2s/v2.1/task/skin-analysis-recommendation/{task_id}","summary":"查询「肤质分析 + 商品推荐」任务的状态。","prefix":{"name":"get","color":"get"},"badges":[],"link":"/analysis-+-product-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get","deprecated":false}]}]}]}]}},{"type":"group","label":"Analysis + Report + Recommendation","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation","items":[{"type":"link","label":"接口总览","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/接口总览","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/接口总览","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"接口总览"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"analysis-+-report-+-recommendation/接口总览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口总览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"这是什么。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 一次调用同时拿到「AI 肤质分析 + 高级测肤报告 + 商品推荐」。您会得到那份精准报告——它建立在实测皮肤指标与专业护肤参考数据库之上——"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"再加上"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"完全从您自家商品里给出的推荐，只需一个请求、一次轮询流程。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"一个接口调用就把整个闭环走完：既有科学、高度可靠、精准的肤质分析报告，又有完全基于您的商品目录的商品推荐。商品曝光与用户黏性一次兼顾，用户体验从头到尾不断档。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"前置准备——上传您的商品目录"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品目录就是肤质分析做推荐时使用的那份商品清单。上传一次，记下它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，之后每次测肤都传入这个 id。目录归属于您的"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"账号"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，不属于某一个 API 密钥——账号下的每个密钥（包括项目密钥）看到的都是同一批目录，轮换密钥或删除密钥都不会影响它们。上传与存储目录完全免费。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录文件要求"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"项目"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"取值"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"格式"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"带表头行的 CSV"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"编码"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"UTF-8，带或不带 BOM 皆可（Excel 的\"CSV UTF-8\"会带上 BOM）"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件大小上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"5 MB"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SKU 数量上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"除文件大小外没有限制"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填栏位"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"、"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_name"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"、"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_description"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"其他栏位会被忽略，但仍计入 5 MB 的大小限制。取值中包含逗号或换行时，必须按标准 CSV 的规则加引号。每一行非空的数据行算作一个 SKU。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\nSKU-003,Barrier Repair Cream,\"Rich cream for dry, redness-prone skin.\"\n","language":"csv"},"children":[{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\nSKU-003,Barrier Repair Cream,\"Rich cream for dry, redness-prone skin.\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"content":"# Upload a catalog — validated in the same request\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/product-catalog\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -F \"file=@catalog.csv\" \\\n  -F \"name=Summer skincare\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Upload a catalog — validated in the same request\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/product-catalog\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -F \"file=@catalog.csv\" \\\n  -F \"name=Summer skincare\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件校验通过时，响应会给出 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"status: ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，并带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——请务必记下这个 id："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"catalog_id\": \"1662043585118399001\",\n    \"name\": \"Summer skincare\",\n    \"status\": \"ready\",\n    \"created_time\": 1760256000000,\n    \"sku_count\": 3\n  }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","attributes":{"content":"{\n  \"status\": 200,\n  \"data\": {\n    \"catalog_id\": \"1662043585118399001\",\n    \"name\": \"Summer skincare\",\n    \"status\": \"ready\",\n    \"created_time\": 1760256000000,\n    \"sku_count\": 3\n  }\n}\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"content":"# List every catalog of your account, newest first (ready and failed alike)\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \"$BASE_URL/s2s/v2.1/product-catalog\"\n\n# Delete a catalog — immediate and permanent\ncurl -sS -X DELETE -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# List every catalog of your account, newest first (ready and failed alike)\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \"$BASE_URL/s2s/v2.1/product-catalog\"\n\n# Delete a catalog — immediate and permanent\ncurl -sS -X DELETE -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录状态与限制"},"children":[],"type":"text"}],"type":"strong"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"状态"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"含义"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可用于测肤"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传并通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传，但文件未通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"未通过校验的上传会返回错误，同时"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"仍会被记录成一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，在「列出目录」里能看到它；错误响应体中不会带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。每个账号最多保留 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"10 个目录"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 合并计算——要先删掉一个，才能上传新的。更新目录的做法是上传一份新文件：每次上传都会产生一个新的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，旧目录在您删除之前一直可用，因此可以先确认新目录没问题再切换。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"创建 AI 任务"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{"content":"# Skin Intel System — Report + Recommendations\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\n      \"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\",\n      \"hd_acne\", \"hd_redness\", \"hd_oiliness\", \"hd_moisture\",\n      \"hd_age_spot\", \"hd_radiance\", \"hd_dark_circle\", \"hd_firmness\",\n      \"hd_eye_bag\", \"hd_tear_trough\", \"hd_droopy_upper_eyelid\",\n      \"hd_droopy_lower_eyelid\"\n    ],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"miniserver_args\": {\n      \"enable_mask_overlay\": true\n    },\n    \"advanced_report\": {\n      \"language\": \"enu\",\n      \"tone\": \"warm\",\n      \"country\": \"United States\",\n      \"city\": \"New York\"\n    },\n    \"product_recommendation\": {\n      \"catalog_id\": \"1662043585118399001\",\n      \"top_n\": 3\n    }\n  }'\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# Skin Intel System — Report + Recommendations\ncurl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"src_file_url\": \"https://your-cdn.example.com/customer-001.jpg\",\n    \"dst_actions\": [\n      \"hd_skin_type\", \"hd_wrinkle\", \"hd_pore\", \"hd_texture\",\n      \"hd_acne\", \"hd_redness\", \"hd_oiliness\", \"hd_moisture\",\n      \"hd_age_spot\", \"hd_radiance\", \"hd_dark_circle\", \"hd_firmness\",\n      \"hd_eye_bag\", \"hd_tear_trough\", \"hd_droopy_upper_eyelid\",\n      \"hd_droopy_lower_eyelid\"\n    ],\n    \"format\": \"zip\",\n    \"pf_camera_kit\": true,\n    \"miniserver_args\": {\n      \"enable_mask_overlay\": true\n    },\n    \"advanced_report\": {\n      \"language\": \"enu\",\n      \"tone\": \"warm\",\n      \"country\": \"United States\",\n      \"city\": \"New York\"\n    },\n    \"product_recommendation\": {\n      \"catalog_id\": \"1662043585118399001\",\n      \"top_n\": 3\n    }\n  }'\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"轮询获取报告与推荐"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每次调用都会立刻返回一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskResponseV2"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用返回的 id 轮询任务即可；报告与推荐结果都在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results.json"},"children":[],"type":"code"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation/$TASK_ID\"\n","language":"bash"},"children":[{"$$mdtype":"Node","attributes":{"content":"# 1. Run the task and capture the task id\nTASK_ID=$(curl -sS -X POST \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation\" \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }' | jq -r '.data.task_id')\n\n# 2. Poll until task_status is \"success\"\ncurl -sS -H \"Authorization: Bearer $API_KEY\" \\\n  \"$BASE_URL/s2s/v2.1/task/skin-analysis-report-recommendation/$TASK_ID\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_status"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会从 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"running"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 走到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" | "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.url"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 是一条有效期为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2 小时"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"的下载链接，ZIP 里有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"skinanalysisResult"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，内含 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"score_info.json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 和所有检测结果图片。用 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"format: json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"results.output"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 会把评分直接写在响应体里。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求字段速查"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"字段"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" / "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"src_file_url"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是（二选一）"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"输入图片，规则同 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"BasicRunTaskV2"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dst_actions"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"是"},"children":[],"type":"text"}],"type":"strong"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么全是 HD 项目，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要么"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"全是 SD 项目——不能混用"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"format"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"（默认）| "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"——两者的响应结构不同"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pf_camera_kit"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"V2.1 新增；脸部轮廓与五官定位"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"miniserver_args"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"蒙版叠加，以及 HD 毛孔／皱纹的底图控制项"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"advanced_report"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出报告；"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"{}"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 表示全部用默认值；不传就没有报告"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"否"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"传了就出推荐；需要 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分辨率。"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 所有输出图片的长边都限制在 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"2560 px"},"children":[],"type":"text"}],"type":"strong"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 以内，输入图片会自动缩放。若 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"enable_mask_overlay"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"false"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，您拿到的是原始蒙版 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":".png"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，需要自行合成——请先确认输入图片的分辨率，长边超过 2560 px 时，按 2560 px 来规划您的显示尺寸。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[],"type":"hr"}]}],"panels":[]}]}},{"label":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post","metadata":{"seo":{"title":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。","description":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 success 或 error 通知后，用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 通知后，用收到的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 查询任务结果。配置与校验的细节请见 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"href":"/develop/webhook"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Webhook 接入指南"},"children":[],"type":"text"}],"type":"link"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"若功能不支持 Webhook，或您的接入方式用不了 Webhook，就请实现轮询。提交 AI 任务后，按固定间隔（例如每 10 秒）轮询状态接口，直到任务状态变为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"success"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 或 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"error"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_10"}},"schemaId":"schema_10","pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/s2s/v2.1/task/skin-analysis-report-recommendation","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_10"}},"responseCodes":["200","400","401","429"],"pointer":"/s2s/v2.1/task/skin-analysis-report-recommendation","href":"analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post","summary":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"schemaId":"schema_10","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_10"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"「肤质分析 + 高级测肤报告 + 商品推荐」任务执行成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}},"schemaId":"components/schemas/BasicRunTaskResponseV2"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行失败。除常见情况外，出现下列情况时请求会返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，且不扣点数："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"未提供 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"提供了 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 却没有 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不存在、已被删除，或属于其他账号"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 指向的目录在上传时未通过校验"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不是不小于 1 的整数"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_recommendation.top_n"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 大于目录中的商品数量"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]}},"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"429","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"请求过多"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}},"schemaId":"schema_3"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BasicRunTaskResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BasicRunTaskResponseV2"}}},{"code":"400","schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"]}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"429","schemaId":"schema_3","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-report-recommendation"},{"label":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get","routeSlug":"/zh-cn/reference/ai_skin_analysis/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get","metadata":{"seo":{"title":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。","description":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"task_id","in":"path","schemaId":"schema_4","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"要查询的任务 ID"},"children":[],"type":"text"}],"type":"paragraph"}],"required":true}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.1/task/skin-analysis-report-recommendation/{task_id}","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[{"name":"task_id","in":"path","required":true,"example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe","schemaId":"schema_4"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/s2s/v2.1/task/skin-analysis-report-recommendation/{task_id}","href":"analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get","summary":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析任务状态查询成功"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}},"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务 ID 无效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}},"schemaId":"schema_6"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"500","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务执行超时"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}},"schemaId":"schema_7"}],"pointer":"/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success","paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"]}}},{"code":"400","schemaId":"schema_6","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_6"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"500","schemaId":"schema_7","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_7"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get"}],"panels":[]}]},"httpPath":"/s2s/v2.1/task/skin-analysis-report-recommendation/{task_id}"}],"content":{"contentType":"group","meta":{"name":"Analysis + Report + Recommendation"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Analysis + Report + Recommendation","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/s2s/v2.1/task/skin-analysis-report-recommendation","summary":"执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。","prefix":{"name":"post","color":"post"},"badges":[],"link":"/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post","deprecated":false},{"title":"/s2s/v2.1/task/skin-analysis-report-recommendation/{task_id}","summary":"查询「肤质分析 + 高级测肤报告 + 商品推荐」任务的状态。","prefix":{"name":"get","color":"get"},"badges":[],"link":"/analysis-+-report-+-recommendation/paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get","deprecated":false}]}]}]}]}},{"type":"group","label":"Product Catalogs","link":"/zh-cn/reference/ai_skin_analysis/product-catalogs","routeSlug":"/zh-cn/reference/ai_skin_analysis/product-catalogs","items":[{"type":"link","label":"接口总览","link":"/zh-cn/reference/ai_skin_analysis/product-catalogs/接口总览","routeSlug":"/zh-cn/reference/ai_skin_analysis/product-catalogs/接口总览","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"接口总览"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{"level":2,"id":"product-catalogs/接口总览"},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"接口总览"},"children":[],"type":"text"}],"type":"heading"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品目录就是 AI 肤质分析在做商品推荐时使用的那份商品清单。您的目录只需上传一次，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"记下它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，把这个 id 传给测肤即可。目录会一直保留，直到您删除它。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录归属于您的账号，不属于某一个 API 密钥：账号下的每个 API 密钥——包括项目密钥——"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"看到的都是同一批目录；轮换密钥或删除密钥都不会影响它们。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传与存储目录完全免费。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录文件"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"项目"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"取值"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"格式"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"带表头行的 CSV"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"编码"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"UTF-8，带或不带字节顺序标记（BOM）皆可。Excel 的\"CSV UTF-8\"格式会带上 BOM。"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"文件大小上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"5 MB"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SKU 数量上限"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"除文件大小外没有限制"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填栏位："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"栏位"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"说明"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_id"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"您的商品编号"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_name"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品名称"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"product_description"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"商品描述"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"其他栏位会被忽略，但仍计入 5 MB 的大小限制。取值中包含逗号或换行时，必须按标准 CSV 的规则"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"加引号。每一行非空的数据行算作一个 SKU。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"示例："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\n","language":"csv"},"children":[{"$$mdtype":"Node","attributes":{"content":"product_id,product_name,product_description\nSKU-001,Hydrating Serum,\"A lightweight serum for dry skin.\"\nSKU-002,Brightening Cream,\"Evens out skin tone, for daily use.\"\n"},"children":[],"type":"text"}],"type":"fence"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录状态"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"状态"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"含义"},"children":[],"type":"text"}],"type":"th"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可用于测肤"},"children":[],"type":"text"}],"type":"th"}],"type":"tr"}],"type":"thead"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传并通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"已上传，但文件未通过校验"},"children":[],"type":"text"}],"type":"td"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"不可以"},"children":[],"type":"text"}],"type":"td"}],"type":"tr"}],"type":"tbody"}],"type":"table"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"未通过校验的上传会返回错误，同时仍会记录为一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，\"列出目录\"接口"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"会把它列出来。删除它和删除其他目录一样操作。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"限制"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每个账号最多可保留 10 个目录，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 合并计算。要先删除一个目录，才能上传新的。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"更新目录的做法是上传一份新文件：每次上传都会产生一个新的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，旧目录会一直可用，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"直到您删除它，因此您可以先确认新目录没问题再切换。"},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"删除"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"删除目录立即生效且不可撤销。从那一刻起，所有使用该 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 的测肤调用都会失败。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"已删除的目录无法恢复；重新上传同一个文件，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"会创建一个全新的目录、对应一个新的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]}],"panels":[]}]}},{"label":"上传商品目录。","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/post","routeSlug":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/post","metadata":{"seo":{"title":"上传商品目录。","description":"以 CSV 文件上传商品目录。文件会在同一次请求中完成校验：校验通过的文件返回 status ready，并带上它的 catalog_id 与 sku_count；未通过校验的文件返回错误，同时仍会记录为一个 failed 目录，「列出目录」接口会把它列出来。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"上传商品目录。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1product-catalog/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"上传商品目录。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"以 CSV 文件上传商品目录。文件会在同一次请求中完成校验：校验通过的文件返回 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"status"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，并带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku_count"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"；未通过校验的文件返回错误，同时仍会记录为一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录，「列出目录」接口会把它列出来。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_11"}},"schemaId":"schema_11","pointer":"/paths/~1s2s~1v2.1~1product-catalog/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/s2s/v2.1/product-catalog","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_11"}},"responseCodes":["200","400","401"],"pointer":"/s2s/v2.1/product-catalog","href":"product-catalogs/paths/~1s2s~1v2.1~1product-catalog/post","summary":"上传商品目录。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"schemaId":"schema_11","mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_11"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录已上传，可用于测肤"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12"}},"schemaId":"schema_12"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传被拒绝。未通过校验的文件仍会记录为一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录；错误响应体中不会带上它的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13"}},"schemaId":"schema_13"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"}],"pointer":"/paths/~1s2s~1v2.1~1product-catalog/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_12","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12"}}},{"code":"400","schemaId":"schema_13","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/post"}],"panels":[]}]},"httpPath":"/s2s/v2.1/product-catalog"},{"label":"列出商品目录。","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/get","routeSlug":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/get","metadata":{"seo":{"title":"列出商品目录。","description":"列出您账号下的所有目录，最新的排在最前面，ready 与 failed 都会列出。手上没有了某个 catalog_id 时，可以用它找回来。该接口不分页：每个账号可保留的目录数量有上限（见「商品目录」章节下的「限制」）。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"列出商品目录。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1product-catalog/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"列出商品目录。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"列出您账号下的所有目录，最新的排在最前面，"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 与 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 都会列出。手上没有了某个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时，可以用它找回来。该接口不分页：每个账号可保留的目录数量有上限（见「商品目录」章节下的「限制」）。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.1/product-catalog","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/s2s/v2.1/product-catalog","href":"product-catalogs/paths/~1s2s~1v2.1~1product-catalog/get","summary":"列出商品目录。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"账号下的所有目录"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"}],"pointer":"/paths/~1s2s~1v2.1~1product-catalog/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/get"}],"panels":[]}]},"httpPath":"/s2s/v2.1/product-catalog"},{"label":"删除商品目录。","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete","routeSlug":"/zh-cn/reference/ai_skin_analysis/product-catalogs/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete","metadata":{"seo":{"title":"删除商品目录。","description":"删除目录立即生效且不可撤销。从那一刻起，所有使用该 catalog_id 的测肤调用都会失败。已删除的目录无法恢复。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"删除商品目录。","isWebhook":false,"pointer":"/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"删除商品目录。","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"删除目录立即生效且不可撤销。从那一刻起，所有使用该 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 的测肤调用都会失败。已删除的目录无法恢复。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalog_id","in":"path","schemaId":"schema_15","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"「上传商品目录」返回的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"required":true}],"pointer":"/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/s2s/v2.1/product-catalog/{catalog_id}","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[{"name":"catalog_id","in":"path","required":true,"example":"1662043585118399001","schemaId":"schema_15"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/s2s/v2.1/product-catalog/{catalog_id}","href":"product-catalogs/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete","summary":"删除商品目录。"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录已删除"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_16"}},"schemaId":"schema_16"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 密钥无效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}},"schemaId":"schema_2"},{"code":"404","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"您的账号中不存在该 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 对应的目录"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_17"}},"schemaId":"schema_17"}],"pointer":"/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_16","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_16"}}},{"code":"401","schemaId":"schema_2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2"}}},{"code":"404","schemaId":"schema_17","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_17"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete"}],"panels":[]}]},"httpPath":"/s2s/v2.1/product-catalog/{catalog_id}"}],"content":{"contentType":"group","meta":{"name":"Product Catalogs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Catalogs","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/s2s/v2.1/product-catalog","summary":"上传商品目录。","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/post","deprecated":false},{"title":"/s2s/v2.1/product-catalog","summary":"列出商品目录。","prefix":{"name":"get","color":"get"},"badges":[],"link":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog/get","deprecated":false},{"title":"/s2s/v2.1/product-catalog/{catalog_id}","summary":"删除商品目录。","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/product-catalogs/paths/~1s2s~1v2.1~1product-catalog~1{catalog_id}/delete","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/RunSkincareTaskV2":{"id":"components/schemas/RunSkincareTaskV2","kind":"json-schema","title":"RunSkincareTaskV2","data":{"allOf":[{"$ref":"#/components/schemas/BasicRunTaskV2"},{"title":"RunSkincareTaskV2","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"该对象表示一次 AI 肤质分析任务的运行。"},"children":[],"type":"text"}],"type":"paragraph"}],"type":"object","properties":{"dst_actions":{"$ref":"#/components/schemas/RunSkincareTaskDstActions"},"miniserver_args":{"$ref":"#/components/schemas/RunSkincareTaskMiniserverArgs"},"format":{"type":"string","enum":["json","zip"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析结果的返回格式，默认为 'zip'。 - "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"：结果打包成可下载的 ZIP 文件，内含 skinanalysisResult 目录， 包含 score_info.json 与全部检测结果图片。响应中会给出下载该 ZIP 的 URL。 - "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"：结果直接以 JSON 形式在响应体中返回。 注意：format=json 与 format=zip 的响应结构不同。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"zip"}},"required":["dst_actions"]}]}},"components/schemas/RunSkincareTaskDstActions":{"id":"components/schemas/RunSkincareTaskDstActions","kind":"json-schema","title":"RunSkincareTaskDstActions","data":{"type":"array","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析的分析项目。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析项目分为 HD 与 SD 两类。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"您可以选择一个或多个项目，但必须全部为 SD 或全部为 HD。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"注意：HD 与 SD 项目不能混用。"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{},"children":[],"type":"softbreak"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"HD 项目："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_redness：衡量泛红严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_oiliness：判断出油程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_age_spot：检测老年斑与色素沉着。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_radiance：评估肌肤光泽度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_moisture：评估肌肤含水量。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_dark_circle：分析眼下黑眼圈情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_eye_bag：检测眼袋。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_droopy_upper_eyelid：衡量上睑下垂严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_droopy_lower_eyelid：衡量下睑下垂严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_firmness：评估肌肤紧致度与弹性。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_texture：分析整体肤质纹理。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_acne：检测痘痘情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_pore：检测并评估各面部区域的毛孔（额头、鼻、颊、全脸）。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_wrinkle：衡量各面部区域皱纹的严重程度（额头、眉间、眼角、眼周、法令纹、木偶纹、全脸）。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_tear_trough：检测泪沟。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"hd_skin_type：按子类（全脸、T 区、U 区）判定肤质，取值为中性、油性、干性、混合性、泛红、干性伴泛红、油性伴泛红、混合性伴泛红。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"SD 项目："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"wrinkle：皱纹总体分析。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"droopy_upper_eyelid：衡量上睑下垂严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"droopy_lower_eyelid：衡量下睑下垂严重程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"firmness：评估肌肤紧致度与弹性。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"acne：评估痘痘情况。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"moisture：衡量肌肤含水量。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"eye_bag：检测眼袋。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"dark_circle_v2：分析黑眼圈。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"age_spot：检测老年斑。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"radiance：评估肌肤明亮度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"redness：衡量泛红程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"oiliness：判断出油程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"pore：衡量毛孔明显程度。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"texture：分析整体肤质纹理。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"tear_trough：检测泪沟。"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"skin_type：按子类（全脸、T 区、U 区）判定肤质，取值为中性、油性、干性、混合性、泛红、干性伴泛红、油性伴泛红、混合性伴泛红。"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}],"items":{"type":"string","enum":["hd_wrinkle","hd_pore","hd_texture","hd_acne","hd_oiliness","hd_radiance","hd_eye_bag","hd_age_spot","hd_dark_circle","hd_droopy_upper_eyelid","hd_droopy_lower_eyelid","hd_firmness","hd_moisture","hd_redness","hd_tear_trough","hd_skin_type","wrinkle","pore","texture","acne","oiliness","radiance","eye_bag","age_spot","dark_circle_v2","droopy_upper_eyelid","droopy_lower_eyelid","firmness","moisture","redness","tear_trough","skin_type"]},"example":["hd_wrinkle","hd_pore","hd_texture","hd_acne"]}},"components/schemas/RunSkincareTaskMiniserverArgs":{"id":"components/schemas/RunSkincareTaskMiniserverArgs","kind":"json-schema","title":"RunSkincareTaskMiniserverArgs","data":{"type":"object","properties":{"enable_mask_overlay":{"type":"boolean","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"控制是否把蒙版叠加到图片上。为 true 时返回叠加后的 .jpg， 为 false 时返回原始蒙版 .png。默认为 false。 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"name":"br","attrs":{}},"children":[],"type":"tag","tag":"html"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 所有输出图片的长边最高为 2560 像素。若未启用 enable_mask_overlay，您需要自行确认输入分辨率是否超过 2560，并在客户端相应处理蒙版叠加。当输入图片长边小于 2560 像素时，按原图分辨率显示；否则请按 2560 像素配置显示。"},"children":[],"type":"text"}],"type":"paragraph"}]},"enable_dark_background_hd_pore":{"type":"boolean","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"为高清毛孔可视化启用深色底"},"children":[],"type":"text"}],"type":"paragraph"}]},"color_dark_background_hd_pore":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高清毛孔深色底可视化所用的颜色（十六进制）"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"3D3D3D"},"opacity_dark_background_hd_pore":{"type":"number","minimum":0,"maximum":1,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高清毛孔深色底可视化的不透明度"},"children":[],"type":"text"}],"type":"paragraph"}],"example":0.4},"enable_dark_background_hd_wrinkle":{"type":"boolean","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"为高清皱纹可视化启用深色底"},"children":[],"type":"text"}],"type":"paragraph"}]},"color_dark_background_hd_wrinkle":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高清皱纹深色底可视化所用的颜色（十六进制）"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"3D3D3D"},"opacity_dark_background_hd_wrinkle":{"type":"number","minimum":0,"maximum":1,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高清皱纹深色底可视化的不透明度"},"children":[],"type":"text"}],"type":"paragraph"}],"example":0.4}}}},"components/schemas/SkinAnalysisResponseV2":{"id":"components/schemas/SkinAnalysisResponseV2","kind":"json-schema","title":"SkinAnalysisResponseV2","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200},"data":{"type":"object","properties":{"task_status":{"type":"string","enum":["running","success","error"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"$ref":"#/components/schemas/EngineErrorCode"},"error_message":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误的详细说明"},"children":[],"type":"text"}],"type":"paragraph"}]},"results":{"oneOf":[{"$ref":"#/components/schemas/SkinAnalysisResultsV2Zip"},{"$ref":"#/components/schemas/SkinAnalysisResultsV2Json"}]}}}}}},"components/schemas/SkinAnalysisResultsV2Zip":{"id":"components/schemas/SkinAnalysisResultsV2Zip","kind":"json-schema","title":"SkinAnalysisResultsV2Zip","data":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"该结果的下载 URL，有效期 2 小时。返回的 ZIP 文件内含 skinanalysisResult 目录，其中的 score_info.json 记录了全部检测项的评分， 目录中还包含所有检测结果图片。若请求了高级测肤报告或商品推荐， 目录中还会有 llm_results.json。 仅在 format 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"zip"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时提供。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"https://example.com/sample-result-url"}}}},"components/schemas/SkinAnalysisResultsV2Json":{"id":"components/schemas/SkinAnalysisResultsV2Json","kind":"json-schema","title":"SkinAnalysisResultsV2Json","data":{"type":"object","required":["output"],"properties":{"output":{"type":"array","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析结果以 JSON 格式直接写在响应体中。 当请求了高级测肤报告或商品推荐时，输出中还会有一个 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"type"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"llm_results"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 的条目，其 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"mask_urls[0]"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 即 llm_results.json 的 URL。 仅在 format 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"json"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 时可用。"},"children":[],"type":"text"}],"type":"paragraph"}],"items":{"type":"object","properties":{"type":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"AI 肤质分析的分析项目"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"hd_skin_type"},"region":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析所聚焦的面部区域"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"whole"},"raw_score":{"type":"number","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"1 到 100 之间的浮点数。raw_score 指 AI 模型直接预测出的分数"},"children":[],"type":"text"}],"type":"paragraph"}],"example":98.5},"ui_score":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"1 到 100 之间的整数。ui_score 是在 raw_score 基础上调整后的分数"},"children":[],"type":"text"}],"type":"paragraph"}],"example":97},"score":{"type":"number","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"1 到 100 之间的浮点数，表示肌肤整体状况。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":97.66},"mask_urls":{"type":"array","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"分析过程中生成的蒙版图或缩放图的 URL"},"children":[],"type":"text"}],"type":"paragraph"}],"items":{"type":"string","example":"https://example.com/mask_image_1.png"}}}}}}}},"components/schemas/SkinAnalysisAdvancedReport":{"id":"components/schemas/SkinAnalysisAdvancedReport","kind":"json-schema","title":"SkinAnalysisAdvancedReport","data":{"type":"object","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"高级测肤报告的选项，结果放在 llm_results.json 里返回。不传这个对象、或传一个空对象，就全部用默认值。"},"children":[],"type":"text"}],"type":"paragraph"}],"properties":{"language":{"type":"string","enum":["enu","cht","jpn","kor","fra","deu","esn","ita","ptb","ind","ara"],"default":"enu","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"报告使用的语言。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"cht"},"tone":{"type":"string","enum":["warm","direct"],"default":"warm","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"报告的语气。两种语气都保持专业。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"direct"},"country":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用来给报告加上气候与季节背景的国家。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"Taiwan"},"city":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用来给报告加上气候与季节背景的城市。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"Taipei"}}}},"components/schemas/SkinAnalysisProductRecommendation":{"id":"components/schemas/SkinAnalysisProductRecommendation","kind":"json-schema","title":"SkinAnalysisProductRecommendation","data":{"type":"object","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填。从您的某个商品目录里推荐商品，结果放在 llm_results.json 里返回。"},"children":[],"type":"text"}],"type":"paragraph"}],"properties":{"catalog_id":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"必填。您通过商品目录接口上传的商品目录 ID。该目录必须处于 ready 状态，且属于您的账号。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"123456789012345678"},"top_n":{"type":"integer","minimum":1,"default":3,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每类皮肤问题要推荐的商品数。不能超过目录里的商品数量。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":3}}}},"components/schemas/ProductCatalog":{"id":"components/schemas/ProductCatalog","kind":"json-schema","title":"ProductCatalog","data":{"type":"object","properties":{"catalog_id":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"随机生成、无法猜出的目录 ID。在测肤时传入它，即可使用这个目录。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"1662043585118399001"},"name":{"type":"string","nullable":true,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传时给目录起的名称；未填时为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"Summer skincare"},"status":{"type":"string","enum":["ready","failed"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录状态："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ready - 已上传并通过校验，可用于测肤"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed - 文件未通过校验，不可使用"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]},"created_time":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"上传时间，Unix 时间戳（毫秒）"},"children":[],"type":"text"}],"type":"paragraph"}],"example":1760256000000},"sku_count":{"type":"integer","nullable":true,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"从文件中解析出的商品数量；"},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"failed"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 目录为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":3}}}},"components/schemas/BasicRunTaskV2SrcFileUrl":{"id":"components/schemas/BasicRunTaskV2SrcFileUrl","kind":"json-schema","title":"BasicRunTaskV2SrcFileUrl","data":{"type":"object","required":["src_file_url"],"properties":{"src_file_url":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用于运行任务的文件 URL，该 URL 需可公开访问。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"https://example.com/selfie.jpg"}}}},"components/schemas/BasicRunTaskV2SrcFileId":{"id":"components/schemas/BasicRunTaskV2SrcFileId","kind":"json-schema","title":"BasicRunTaskV2SrcFileId","data":{"type":"object","required":["src_file_id"],"properties":{"src_file_id":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"用于运行任务的文件 ID，取自上传文件接口返回的 file_id。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="}}}},"components/schemas/BasicRunTaskV2":{"id":"components/schemas/BasicRunTaskV2","kind":"json-schema","title":"BasicRunTaskV2","data":{"title":"BasicRunTaskV2","anyOf":[{"title":"用源文件 URL 运行任务","allOf":[{"$ref":"#/components/schemas/BasicRunTaskV2SrcFileUrl"}]},{"title":"用源文件 ID 运行任务","allOf":[{"$ref":"#/components/schemas/BasicRunTaskV2SrcFileId"}]}]}},"components/schemas/BasicRunTaskResponseV2":{"id":"components/schemas/BasicRunTaskResponseV2","kind":"json-schema","title":"BasicRunTaskResponseV2","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200},"data":{"type":"object","properties":{"task_id":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"该任务的 ID。凭这个 ID 可在 24 小时内查询任务结果。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"}}}}}},"components/schemas/RunError":{"id":"components/schemas/RunError","kind":"json-schema","title":"RunError","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":400},"error":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误信息"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"The operation could not be completed"},"error_code":{"type":"string","enum":["InvalidParameters","CreditInsufficiency","InvalidStyleGroup","InvalidStyle","BadRequest"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters - 请求参数无效"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"CreditInsufficiency - 点数不足，无法运行"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"BadRequest - 请求参数不符合预期"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidStyleGroup - 风格分组 ID 无效"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidStyle - 风格 ID 无效"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]}}}},"components/schemas/EngineErrorCode":{"id":"components/schemas/EngineErrorCode","kind":"json-schema","title":"EngineErrorCode","data":{"type":"string","nullable":true,"enum":["error_exceed_max_image_size","exceed_max_filesize","invalid_parameter","error_download_image","error_download_mask","error_decode_image","error_decode_mask","error_nsfw_content_detected","error_no_face","error_pose","error_face_parsing","error_inference","exceed_nsfw_retry_limits","error_upload","unknown_internal_error"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_exceed_max_image_size`  - 输入图片尺寸超出上限"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`exceed_max_filesize` - 输入文件大小超出上限"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`invalid_parameter` - 参数取值无效"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_download_image` - 下载原图出错"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_download_mask` - 下载蒙版图片出错"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_decode_image` - 解码原图出错"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_decode_mask` - 解码蒙版图片出错"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_nsfw_content_detected` - 在原图中检测到不适宜内容（NSFW）"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_no_face` - 原图中没有检测到人脸"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_pose` - 原图的姿态检测失败"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_face_parsing` - 原图的人脸分割失败"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_inference` - 推理流程中出现错误"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`exceed_nsfw_retry_limits` - 为避免生成不适宜内容， 重试次数已用尽"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`error_upload` - 上传结果图片出错"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"`unknown_internal_error` - 其他错误"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]}},"schema_0":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/RunSkincareTaskV2"},{"type":"object","properties":{"pf_camera_kit":{"type":"boolean","example":true}}}]},"id":"schema_0"},"schema_1":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/RunError"}]},"id":"schema_1"},"schema_2":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":401,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Invalid API key"}}},"id":"schema_2"},"schema_3":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":429,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Too many requests"}}},"id":"schema_3"},"schema_4":{"kind":"json-schema","data":{"type":"string","example":"grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"},"id":"schema_4"},"schema_5":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/SkinAnalysisResponseV2"}]},"id":"schema_5"},"schema_6":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":400,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Invalid task ID"}}},"id":"schema_6"},"schema_7":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":500,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Task execution timed out"}}},"id":"schema_7"},"schema_8":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/RunSkincareTaskV2"},{"type":"object","properties":{"pf_camera_kit":{"type":"boolean","example":true},"advanced_report":{"$ref":"#/components/schemas/SkinAnalysisAdvancedReport"}}}]},"id":"schema_8"},"schema_9":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/RunSkincareTaskV2"},{"type":"object","properties":{"pf_camera_kit":{"type":"boolean","example":true},"product_recommendation":{"$ref":"#/components/schemas/SkinAnalysisProductRecommendation"}}}]},"id":"schema_9"},"schema_10":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/RunSkincareTaskV2"},{"type":"object","properties":{"pf_camera_kit":{"type":"boolean","example":true},"advanced_report":{"$ref":"#/components/schemas/SkinAnalysisAdvancedReport"},"product_recommendation":{"$ref":"#/components/schemas/SkinAnalysisProductRecommendation"}}}]},"id":"schema_10"},"schema_11":{"kind":"json-schema","data":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","example":"@catalog.csv","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目录文件。它的格式、编码、大小限制与必填栏位，见「商品目录」章节下的「目录文件」。"},"children":[],"type":"text"}],"type":"paragraph"}]},"name":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"您自己给目录起的名称，会显示在「列出目录」中。不传时 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"name"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 为 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"Summer skincare"}}},"id":"schema_11"},"schema_12":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200},"data":{"$ref":"#/components/schemas/ProductCatalog"}}},"id":"schema_12"},"schema_13":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":400,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误信息"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"The file must be UTF-8 encoded. Detected encoding: BIG5."},"error_code":{"type":"string","enum":["InvalidParameters","ExceedMaxNumOfProductCatalog"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidParameters - 请求或目录文件无效"},"children":[],"type":"text"}],"type":"item"},{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"ExceedMaxNumOfProductCatalog - 账号已保留的目录数量已达上限"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]}}},"id":"schema_13"},"schema_14":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200},"data":{"type":"object","properties":{"catalogs":{"type":"array","items":{"$ref":"#/components/schemas/ProductCatalog"}}}}}},"id":"schema_14"},"schema_15":{"kind":"json-schema","data":{"type":"string","example":"1662043585118399001"},"id":"schema_15"},"schema_16":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200}}},"id":"schema_16"},"schema_17":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":404,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"响应状态"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误信息"},"children":[],"type":"text"}],"type":"paragraph"}],"example":"No catalog was found with this catalog_id."},"error_code":{"type":"string","enum":["NotFound"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"错误码："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"NotFound - 该 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"catalog_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 不存在，或属于其他账号"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]}}},"id":"schema_17"}},"exampleStore":{"paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported":{"value":{"status":400,"error":"advanced_report is not supported by this endpoint.","error_code":"InvalidParameters"},"key":"advanced_report_not_supported","summary":"本接口收到了 advanced_report","id":"paths/~1s2s~1v2.1~1task~1skin-analysis/post/responses/400/content/application~1json/examples/advanced_report_not_supported"},"paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success":{"value":{"status":200,"data":{"task_status":"success","results":"https://example.com/sample-result-url"}},"key":"format_zip_success","summary":"format=zip 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果打包为一个 ZIP 文件。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success":{"value":{"status":200,"data":{"task_status":"success","results":{"output":[{"type":"hd_wrinkle","region":"whole","raw_score":25.3,"ui_score":25,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_whole.jpg"]},{"type":"hd_wrinkle","region":"forehead","raw_score":20.1,"ui_score":20,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_forehead.jpg"]},{"type":"hd_wrinkle","region":"glabellar","raw_score":15.8,"ui_score":16,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_glabellar.jpg"]},{"type":"hd_wrinkle","region":"crowfeet","raw_score":30.5,"ui_score":31,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_crowfeet.jpg"]},{"type":"hd_pore","region":"whole","raw_score":35.2,"ui_score":35,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_whole.jpg"]},{"type":"hd_pore","region":"forehead","raw_score":30,"ui_score":30,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_forehead.jpg"]},{"type":"hd_pore","region":"nose","raw_score":45.7,"ui_score":46,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_nose.jpg"]},{"type":"hd_pore","region":"cheek","raw_score":32.1,"ui_score":32,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_cheek.jpg"]},{"type":"hd_acne","region":"whole","raw_score":12.5,"ui_score":13,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_acne_whole.jpg"]},{"type":"skin_age","score":29},{"type":"all","score":28.5},{"type":"resize_image","mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/resized_image.jpg"]}]}}},"key":"format_json_success","summary":"format=json 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果直接以 JSON 返回，包含各项分数与图片 URL。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported":{"value":{"status":400,"error":"product_recommendation is not supported by this endpoint.","error_code":"InvalidParameters"},"key":"product_recommendation_not_supported","summary":"本接口收到了 product_recommendation","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report/post/responses/400/content/application~1json/examples/product_recommendation_not_supported"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success":{"value":{"status":200,"data":{"task_status":"success","results":"https://example.com/sample-result-url"}},"key":"format_zip_success","summary":"format=zip 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果打包为一个 ZIP 文件。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success":{"value":{"status":200,"data":{"task_status":"success","results":{"output":[{"type":"hd_wrinkle","region":"whole","raw_score":25.3,"ui_score":25,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_whole.jpg"]},{"type":"hd_wrinkle","region":"forehead","raw_score":20.1,"ui_score":20,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_forehead.jpg"]},{"type":"hd_wrinkle","region":"glabellar","raw_score":15.8,"ui_score":16,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_glabellar.jpg"]},{"type":"hd_wrinkle","region":"crowfeet","raw_score":30.5,"ui_score":31,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_crowfeet.jpg"]},{"type":"hd_pore","region":"whole","raw_score":35.2,"ui_score":35,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_whole.jpg"]},{"type":"hd_pore","region":"forehead","raw_score":30,"ui_score":30,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_forehead.jpg"]},{"type":"hd_pore","region":"nose","raw_score":45.7,"ui_score":46,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_nose.jpg"]},{"type":"hd_pore","region":"cheek","raw_score":32.1,"ui_score":32,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_cheek.jpg"]},{"type":"hd_acne","region":"whole","raw_score":12.5,"ui_score":13,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_acne_whole.jpg"]},{"type":"skin_age","score":29},{"type":"all","score":28.5},{"type":"resize_image","mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/resized_image.jpg"]}]}}},"key":"format_json_success","summary":"format=json 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果直接以 JSON 返回，包含各项分数与图片 URL。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required":{"value":{"status":400,"error":"product_recommendation is required for this endpoint.","error_code":"InvalidParameters"},"key":"product_recommendation_required","summary":"缺少 product_recommendation","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported":{"value":{"status":400,"error":"advanced_report is not supported by this endpoint.","error_code":"InvalidParameters"},"key":"advanced_report_not_supported","summary":"本接口收到了 advanced_report","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/advanced_report_not_supported"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required":{"value":{"status":400,"error":"catalog_id is required when product_recommendation is provided.","error_code":"InvalidParameters"},"key":"catalog_id_required","summary":"product_recommendation 没有 catalog_id","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found":{"value":{"status":400,"error":"No catalog was found with this catalog_id.","error_code":"InvalidParameters"},"key":"catalog_not_found","summary":"找不到该 catalog_id","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready":{"value":{"status":400,"error":"This catalog failed validation when it was uploaded and can't be used. Upload the catalog again.","error_code":"InvalidParameters"},"key":"catalog_not_ready","summary":"catalog_id 指向一个校验失败的目录","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count":{"value":{"status":400,"error":"product_recommendation.top_n can't be more than the 3 products in this catalog.","error_code":"InvalidParameters"},"key":"top_n_exceeds_sku_count","summary":"top_n 超过目录中的商品数量","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success":{"value":{"status":200,"data":{"task_status":"success","results":"https://example.com/sample-result-url"}},"key":"format_zip_success","summary":"format=zip 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果打包为一个 ZIP 文件。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success":{"value":{"status":200,"data":{"task_status":"success","results":{"output":[{"type":"hd_wrinkle","region":"whole","raw_score":25.3,"ui_score":25,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_whole.jpg"]},{"type":"hd_wrinkle","region":"forehead","raw_score":20.1,"ui_score":20,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_forehead.jpg"]},{"type":"hd_wrinkle","region":"glabellar","raw_score":15.8,"ui_score":16,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_glabellar.jpg"]},{"type":"hd_wrinkle","region":"crowfeet","raw_score":30.5,"ui_score":31,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_crowfeet.jpg"]},{"type":"hd_pore","region":"whole","raw_score":35.2,"ui_score":35,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_whole.jpg"]},{"type":"hd_pore","region":"forehead","raw_score":30,"ui_score":30,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_forehead.jpg"]},{"type":"hd_pore","region":"nose","raw_score":45.7,"ui_score":46,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_nose.jpg"]},{"type":"hd_pore","region":"cheek","raw_score":32.1,"ui_score":32,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_cheek.jpg"]},{"type":"hd_acne","region":"whole","raw_score":12.5,"ui_score":13,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_acne_whole.jpg"]},{"type":"skin_age","score":29},{"type":"all","score":28.5},{"type":"resize_image","mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/resized_image.jpg"]}]}}},"key":"format_json_success","summary":"format=json 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果直接以 JSON 返回，包含各项分数与图片 URL。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required":{"value":{"status":400,"error":"product_recommendation is required for this endpoint.","error_code":"InvalidParameters"},"key":"product_recommendation_required","summary":"缺少 product_recommendation","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/product_recommendation_required"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required":{"value":{"status":400,"error":"catalog_id is required when product_recommendation is provided.","error_code":"InvalidParameters"},"key":"catalog_id_required","summary":"product_recommendation 没有 catalog_id","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_id_required"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found":{"value":{"status":400,"error":"No catalog was found with this catalog_id.","error_code":"InvalidParameters"},"key":"catalog_not_found","summary":"找不到该 catalog_id","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_found"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready":{"value":{"status":400,"error":"This catalog failed validation when it was uploaded and can't be used. Upload the catalog again.","error_code":"InvalidParameters"},"key":"catalog_not_ready","summary":"catalog_id 指向一个校验失败的目录","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/catalog_not_ready"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count":{"value":{"status":400,"error":"product_recommendation.top_n can't be more than the 3 products in this catalog.","error_code":"InvalidParameters"},"key":"top_n_exceeds_sku_count","summary":"top_n 超过目录中的商品数量","id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation/post/responses/400/content/application~1json/examples/top_n_exceeds_sku_count"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success":{"value":{"status":200,"data":{"task_status":"success","results":"https://example.com/sample-result-url"}},"key":"format_zip_success","summary":"format=zip 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果打包为一个 ZIP 文件。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_zip_success"},"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success":{"value":{"status":200,"data":{"task_status":"success","results":{"output":[{"type":"hd_wrinkle","region":"whole","raw_score":25.3,"ui_score":25,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_whole.jpg"]},{"type":"hd_wrinkle","region":"forehead","raw_score":20.1,"ui_score":20,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_forehead.jpg"]},{"type":"hd_wrinkle","region":"glabellar","raw_score":15.8,"ui_score":16,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_glabellar.jpg"]},{"type":"hd_wrinkle","region":"crowfeet","raw_score":30.5,"ui_score":31,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_wrinkle_crowfeet.jpg"]},{"type":"hd_pore","region":"whole","raw_score":35.2,"ui_score":35,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_whole.jpg"]},{"type":"hd_pore","region":"forehead","raw_score":30,"ui_score":30,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_forehead.jpg"]},{"type":"hd_pore","region":"nose","raw_score":45.7,"ui_score":46,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_nose.jpg"]},{"type":"hd_pore","region":"cheek","raw_score":32.1,"ui_score":32,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_pore_cheek.jpg"]},{"type":"hd_acne","region":"whole","raw_score":12.5,"ui_score":13,"mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/hd_acne_whole.jpg"]},{"type":"skin_age","score":29},{"type":"all","score":28.5},{"type":"resize_image","mask_urls":["https://s3-us-west-2.amazonaws.com/yce-us/results/resized_image.jpg"]}]}}},"key":"format_json_success","summary":"format=json 时的响应（成功）","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"任务已成功完成，结果直接以 JSON 返回，包含各项分数与图片 URL。"},"children":[],"type":"text"}],"type":"paragraph"}],"id":"paths/~1s2s~1v2.1~1task~1skin-analysis-report-recommendation~1{task_id}/get/responses/200/content/application~1json/examples/format_json_success"}},"securitySchemeStore":{"BearerAuthenticationV2":{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}},"specVersion":"3.0.0","servers":[{"url":"https://yce-api-01.makeupar.com"}],"specType":"openapi"},"options":{"layout":"stacked","mockServer":{"off":true,"position":"off"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/@l10n/zh-CN/reference/ai_skin_analysis.json?download"},{"url":"/_bundle/@l10n/zh-CN/reference/ai_skin_analysis.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false,"asyncapi":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"AI 肤质分析 V2.1","description":"# 概览\n![](https://d3ss46vukfdtpo.cloudfront.net/static/media/img_demostore_skincarelive_topbanner.0cffe3a7.jpg)\n\n**AI 肤质分析 V2.1** 只凭一张正脸自拍，就能给出细致的皮肤洞察。它检测 16 项皮肤指标，包括皱纹、毛孔、色斑、泛红与肤质，并标出每一项皮肤问题出现在脸上的哪个位置；同时估算肌肤年龄，并算出一个整体肌肤状况评分。\n\n在 V2.1 中，您可以按需加上两个加购能力，让接入更完整：\n\n- **高级测肤报告**：基于每位用户的检测结果，生成个性化、读起来轻松好懂的皮肤洞察。\n- **商品推荐**：把您商品目录里的商品对应用户的皮肤问题，做出有针对性的购物体验。\n\n可以只用肤质分析，也可以搭配加购能力一起用。想对比这几种用法，请见 [使用场景](#section/overview/use-cases)。\n\n## 接入指南\n* AI 肤质分析怎么拍照\n* 正脸自拍一张\n  - 拍一张清楚的照片即可，正对镜头。头发散下放下来、垂到胸前，视线直视前方，做出正对镜头的角度。\n  - 也可以用 JS Camera Kit 拍照。同样把头发散下放下来、垂到胸前，不要扎起来。\n\n* 接口流程\n**测肤接口使用指引**\n本指引说明如何用 File 接口与 AI 任务接口上传图片并创建 AI 肤质分析。\n\n   * **第 1 步：调整源图尺寸**</br>\n  把图片缩放到支持的尺寸范围——SD 为长边不超过 2560 像素、短边至少 480 像素；HD 为长边不超过 2560 像素、短边至少 1080 像素。详见 **[文件规格与错误码](#section/overview/File-Specs-and-Errors)**\n\n   * **第 2 步：通过 File 接口上传文件元数据**\n- 图片要求\n    - 详见 **[文件规格与错误码](#section/overview/File-Specs-and-Errors)**\n\n发送 POST 请求初始化文件上传：\n\n```bash\ncurl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/file \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_size\": 547541\n      }\n    ]\n  }'\n```\n\n- ***重要***：只调用 File 接口并不等于上传了文件。您必须**另外把文件上传到 File 接口响应中给出的那个 URL**。那个 URL 就是您的上传目标，务必确认文件已成功传过去，再继续往下做。\n\n  > **警告：** 请注意，若未把文件上传到 File 接口响应中给出的 URL，调用 AI 接口时会得到 500 Server Error / unknown_internal_error 或 404 Not Found 错误。\n\n***\n\n   * **第 3 步：取得上传 URL 与文件 ID**\n\n响应中包含：\n\n*   `requests.url` – 用于上传图片的预签名 URL。\n*   `file_id` – 创建 AI 任务用的标识。\n\n**响应示例：**\n\n```json\n{\n  \"status\": 200,\n  \"data\": {\n    \"files\": [\n      {\n        \"content_type\": \"image/png\",\n        \"file_name\": \"skin_analysis_01_3dbd1b6683.png\",\n        \"file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n        \"requests\": [\n          {\n            \"method\": \"PUT\",\n            \"url\": \"https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...\",\n            \"headers\": {\n              \"Content-Length\": \"547541\",\n              \"Content-Type\": \"image/png\"\n            }\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n***\n\n   * **第 4 步：把图片上传到预签名 URL**\n\n使用提供的 `requests.url` 与请求头：\n\n```bash\ncurl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \\\n  --header 'Content-Type: image/png' \\\n  --header 'Content-Length: 547541' \\\n  --data-binary @'./skin_analysis_01_3dbd1b6683.png'\n```\n\n***\n\n   * **第 5 步：创建 AI 任务**\n\n用第 2 步取得的 `file_id` 创建 AI 肤质分析：\n\n```bash\ncurl --request POST \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"src_file_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud\",\n    \"dst_actions\": [\"wrinkle\", \"pore\", \"texture\", \"acne\"],\n    \"miniserver_args\": {\n      \"enable_mask_overlay\": true,\n      \"enable_dark_background_hd_pore\": true,\n      \"color_dark_background_hd_pore\": \"3D3D3D\",\n      \"opacity_dark_background_hd_pore\": 0.4\n      // Additional parameters omitted for brevity\n    },\n    \"format\": \"json\"\n  }'\n```\n  上传完成后，就可以用文件 ID 或图片文件 URL 选择要分析的皮肤问题，详见 **[输入与输出](#section/overview/Inputs-and-Outputs)**。</br>\n  随后用文件 ID 或图片文件 URL 调用 POST 'task/skin-analysis' 执行任务，\n  并取得 ***task_id***。\n  请注意，SD 与 HD 的皮肤问题参数**不可**同时混用。\n\n- **使用已有的公开图片 URL**\n不必上传，发起 AI 任务时直接提供一个可公开访问的图片 URL 也可以。\n\n**响应示例：**\n\n```json\n{\n  \"status\": 200,\n  \"data\": {\n    \"task_id\": \"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT\"\n  }\n}\n```\n\n***\n\n   * **第 6 步：轮询任务状态**\n\n用 `task_id` 取回任务结果：\n\n```bash\ncurl --request GET \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis/<YOUR_TASK_ID> \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'Content-Type: application/json'\n```\n用这个 ***task_id*** 轮询 GET 'task/skin-analysis' 监控任务状态，取得引擎当前的处理进度。引擎完成任务之前，状态会一直是 'running'，这一阶段不消耗点数。\n\n处理完成的结果保留 30 天。\n- 不必用很短的间隔轮询。\n- 在保留期限内，轮询间隔可以自由安排。\n\n  > **重要：** 由于执行时长没有保证，仍然需要轮询来查看任务状态。\n\n引擎成功处理您的输入文件、生成出图后，任务状态会变为 'success'。您会得到处理后图片的 URL 以及一个 dst_id，可直接串联下一个 AI 任务，不必把结果图重新上传。\n\n只有这种情况才会消耗点数。若引擎处理失败，任务状态会变为 'error'，不消耗点数。\n扣除点数时，系统优先扣除临近到期的点数；到期日相同时，优先扣除最早取得的点数。\n\n\n***\n\n   * **第 7 步：解读结果**\n\n响应中包含：\n\n*   `ui_score` – 面向用户的分数。\n*   `raw_score` – 原始分析分数。\n*   `mask_urls` – 检测蒙版的 URL。\n\n**响应示例：**\n\n```json\n{\n  \"status\": 200,\n  \"data\": {\n    \"results\": {\n      \"output\": [\n        {\n          \"type\": \"texture\",\n          \"ui_score\": 68,\n          \"raw_score\": 57.33,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...texture_output.jpg\"]\n        },\n        {\n          \"type\": \"pore\",\n          \"ui_score\": 92,\n          \"raw_score\": 95.34,\n          \"mask_urls\": [\"https://yce-us.s3-accelerate.amazonaws.com/...pore_output.jpg\"]\n        }\n        // Additional results omitted for brevity\n      ]\n    },\n    \"task_status\": \"success\"\n  }\n}\n```\n\n\n* 排障指引\n> **警告：** 请注意，SD 与 HD 的皮肤问题参数**不可**同时混用。偏离这些规范会得到 ***InvalidParameters*** 错误。\n\n  * 若您混用 HD 与 SD 的皮肤问题参数，会得到如下错误：\n    ```json\n    {\n        \"status\": 400,\n        \"error\": \"cannot mix HD and SD dst_actions\",\n        \"error_code\": \"InvalidParameters\"\n    }\n    ```\n  * 若您拼错皮肤问题名称，或传入未知的皮肤问题，会得到如下错误：\n    ```json\n    {\n        \"status\": 400,\n        \"error\": \"Not available dst_action abc123\",\n        \"error_code\": \"InvalidParameters\"\n    }\n    ```\n\n---\n\n* 实际案例：\n![](https://plugins-media.makeupar.com/webconsultation/images/skincare-widget/img_webcm_skincare_service_survey_demo.jpg)\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/skin_analysis_s5_poster_3_dt_85efe14952.png)\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Skincare_Pro_Medspa_Situation_Image_6aea6046f9.jpg)\n\n## 输入与输出\n* 输入参数说明\n控制 AI 肤质分析结果视觉呈现的方式有两种：要么生成多张图片，每项皮肤问题各出一张独立蒙版；要么用 ``enable_mask_overlay`` 参数合成一张叠加图。系统默认输出多张蒙版，如何把每项皮肤问题的蒙版与图片混合，完全由您掌握。\n\n* 默认：enable_mask_overlay false\n  ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/mask_overlay_false_1920_ea1cde0ead.png)\n\n* 把 enable_mask_overlay 设为 true\n  ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/mask_overlay_1920_0fbb4786cc.png)\n\n----\n\n* 输出 ZIP 数据结构说明\n系统会提供一个 ZIP 文件，里面有一个 'skinanalysisResult' 文件夹。该文件夹中有一份 'score_info.json'，收录全部检测分数以及结果图片的对应关系。\n\n'score_info.json' 收录所有测肤检测结果，包含数值分数与对应输出蒙版文件的名称。\n\nPNG 文件是检测结果蒙版，可以叠加到您的原图上。直接用这些 PNG 的 alpha 值与原图混合，就能在原图上直接看到检测结果。\n\n* AI 肤质分析 ZIP 的文件结构\n* HD 护肤 ZIP\n  * skinanalysisResult\n    - score_info.json\n    - hd_acne_output.png\n    - hd_age_spot_output.png\n    - hd_dark_circle_output.png\n    - hd_droopy_lower_eyelid_output.png\n    - hd_droopy_upper_eyelid_output.png\n    - hd_eye_bag_output.png\n    - hd_firmness_output.png\n    - hd_moisture_output.png\n    - hd_oiliness_output.png\n    - hd_radiance_output.png\n    - hd_redness_output.png\n    - hd_texture_output.png\n    - hd_pore_output_all.png\n    - hd_pore_output_cheek.png\n    - hd_pore_output_forehead.png\n    - hd_pore_output_nose.png\n    - hd_wrinkle_output_all.png\n    - hd_wrinkle_output_crowfeet.png\n    - hd_wrinkle_output_forehead.png\n    - hd_wrinkle_output_glabellar.png\n    - hd_wrinkle_output_marionette.png\n    - hd_wrinkle_output_nasolabial.png\n    - hd_wrinkle_output_periocular.png\n    - hd_tear_trough.png\n    - hd_skin_type.png\n\n* SD 护肤 ZIP\n  * skinanalysisResult\n    - score_info.json\n    - acne_output.png\n    - age_spot_output.png\n    - dark_circle_v2_output.png\n    - droopy_lower_eyelid_output.png\n    - droopy_upper_eyelid_output.png\n    - eye_bag_output.png\n    - firmness_output.png\n    - moisture_output.png\n    - oiliness_output.png\n    - pore_output.png\n    - radiance_output.png\n    - redness_output.png\n    - texture_output.png\n    - wrinkle_output.png\n    - tear_trough.png\n    - skin_type.png\n\n* JSON 数据结构（score_info.json）\n  * \"all\"：1 到 100 之间的浮点数，代表整体皮肤状况。分数越高，皮肤越健康、观感越好。\n  * \"skin_age\"：由 AI 推算的皮肤年龄，参照全年龄段人群分布得出。\n  * 每个类别包含：\n    * \"raw_score\"：1 到 100 之间的浮点数。分数越高，皮肤越健康、观感越好。\n    * \"ui_score\"：1 到 100 之间的整数。UI 分数在美容评估中主要起心理激励的作用。我们会调整原始分数，让结果更讨喜——考虑到消费者普遍希望关于自己皮肤状况的评价更正面。这样的校准能让用户更有信心，同时守住美容心理学的底层框架。\n    * \"output_mask_name\"：对应输出蒙版图片的文件名。\n\n  * 类别与说明\n    * HD 护肤：\n        * \"hd_redness\"：衡量泛红严重程度。\n        * \"hd_oiliness\"：判定出油程度。\n        * \"hd_age_spot\"：检测老年斑与色素沉淀。\n        * \"hd_radiance\"：评估光泽度。\n        * \"hd_moisture\"：评估皮肤水润度。\n        * \"hd_dark_circle\"：分析眼下黑眼圈情况。\n        * \"hd_eye_bag\"：检测眼袋。\n        * \"hd_droopy_upper_eyelid\"：衡量上眼皮下垂程度。\n        * \"hd_droopy_lower_eyelid\"：衡量下眼皮下垂程度。\n        * \"hd_firmness\"：评估皮肤紧实度与弹性。\n        * \"hd_texture\"：子类别[whole]；分析整体皮肤纹理。\n        * \"hd_acne\"：子类别[whole]；检测痘痘情况。\n        * \"hd_pore\"：子类别[forehead, nose, cheek, whole]；检测并评估脸部各区域的毛孔。\n        * \"hd_wrinkle\"：子类别[forehead, glabellar, crowfeet, periocular, nasolabial, marionette, whole]；衡量脸部各区域皱纹的严重程度。\n        * \"hd_tear_trough\"：检测泪沟。\n        * \"hd_skin_type\"：子类别[whole, t_zone, u_zone]，评估肤质：Normal、Oily、Dry、Combination、Redness、Dry & Redness、Oily & Redness、Combination & Redness。\n\n    * SD 护肤：\n        * \"wrinkle\"：皱纹综合分析。\n        * \"droopy_upper_eyelid\"：衡量上眼皮下垂程度。\n        * \"droopy_lower_eyelid\"：衡量下眼皮下垂程度。\n        * \"firmness\"：评估皮肤紧实度与弹性。\n        * \"acne\"：评估痘痘情况。\n        * \"moisture\"：衡量皮肤水润度。\n        * \"eye_bag\"：检测眼袋。\n        * \"dark_circle_v2\"：以另一套方法分析黑眼圈。\n        * \"age_spot\"：检测老年斑。\n        * \"radiance\"：评估皮肤明亮度。\n        * \"redness\"：衡量泛红程度。\n        * \"oiliness\"：判定出油程度。\n        * \"pore\"：衡量毛孔明显程度。\n        * \"texture\"：分析整体皮肤纹理。\n        * \"tear_trough\"：检测泪沟。\n        * \"skin_type\"：子类别[whole, t_zone, u_zone]，评估肤质：Normal、Oily、Dry、Combination、Redness、Dry & Redness、Oily & Redness、Combination & Redness。\n\n  * HD 护肤的 score_info.json 示例\n    ```json\n    {\n        \"hd_redness\": {\n            \"raw_score\": 72.011962890625,\n            \"ui_score\": 77,\n            \"output_mask_name\": \"hd_redness_output.png\"\n        },\n        \"hd_oiliness\": {\n            \"raw_score\": 60.74365234375,\n            \"ui_score\": 72,\n            \"output_mask_name\": \"hd_oiliness_output.png\"\n        },\n        \"hd_age_spot\": {\n            \"raw_score\": 83.23274230957031,\n            \"ui_score\": 77,\n            \"output_mask_name\": \"hd_age_spot_output.png\"\n        },\n        \"hd_radiance\": {\n            \"raw_score\": 76.57244205474854,\n            \"ui_score\": 79,\n            \"output_mask_name\": \"hd_radiance_output.png\"\n        },\n        \"hd_moisture\": {\n            \"raw_score\": 48.694559931755066,\n            \"ui_score\": 70,\n            \"output_mask_name\": \"hd_moisture_output.png\"\n        },\n        \"hd_dark_circle\": {\n            \"raw_score\": 80.1993191242218,\n            \"ui_score\": 76,\n            \"output_mask_name\": \"hd_dark_circle_output.png\"\n        },\n        \"hd_eye_bag\": {\n            \"raw_score\": 76.67280435562134,\n            \"ui_score\": 79,\n            \"output_mask_name\": \"hd_eye_bag_output.png\"\n        },\n        \"hd_droopy_upper_eyelid\": {\n            \"raw_score\": 79.05348539352417,\n            \"ui_score\": 80,\n            \"output_mask_name\": \"hd_droopy_upper_eyelid_output.png\"\n        },\n        \"hd_droopy_lower_eyelid\": {\n            \"raw_score\": 79.97175455093384,\n            \"ui_score\": 81,\n            \"output_mask_name\": \"hd_droopy_lower_eyelid_output.png\"\n        },\n        \"hd_firmness\": {\n            \"raw_score\": 89.66898322105408,\n            \"ui_score\": 85,\n            \"output_mask_name\": \"hd_firmness_output.png\"\n        },\n        \"hd_texture\": {\n            \"whole\": {\n                \"raw_score\": 66.3921568627451,\n                \"ui_score\": 75,\n                \"output_mask_name\": \"hd_texture_output.png\"\n            }\n        },\n        \"hd_acne\": {\n            \"whole\": {\n                \"raw_score\": 59.92677688598633,\n                \"ui_score\": 76,\n                \"output_mask_name\": \"hd_acne_output.png\"\n            }\n        },\n        \"hd_pore\": {\n            \"forehead\": {\n                \"raw_score\": 79.59770965576172,\n                \"ui_score\": 80,\n                \"output_mask_name\": \"hd_pore_output_forehead.png\"\n            },\n            \"nose\": {\n                \"raw_score\": 29.139814376831055,\n                \"ui_score\": 58,\n                \"output_mask_name\": \"hd_pore_output_nose.png\"\n            },\n            \"cheek\": {\n                \"raw_score\": 44.11081314086914,\n                \"ui_score\": 65,\n                \"output_mask_name\": \"hd_pore_output_cheek.png\"\n            },\n            \"whole\": {\n                \"raw_score\": 49.23978805541992,\n                \"ui_score\": 67,\n                \"output_mask_name\": \"hd_pore_output_all.png\"\n            }\n        },\n        \"hd_wrinkle\": {\n            \"forehead\": {\n                \"raw_score\": 55.96956729888916,\n                \"ui_score\": 67,\n                \"output_mask_name\": \"hd_wrinkle_output_forehead.png\"\n            },\n            \"glabellar\": {\n                \"raw_score\": 76.7251181602478,\n                \"ui_score\": 75,\n                \"output_mask_name\": \"hd_wrinkle_output_glabellar.png\"\n            },\n            \"crowfeet\": {\n                \"raw_score\": 83.4361481666565,\n                \"ui_score\": 78,\n                \"output_mask_name\": \"hd_wrinkle_output_crowfeet.png\"\n            },\n            \"periocular\": {\n                \"raw_score\": 67.88706302642822,\n                \"ui_score\": 72,\n                \"output_mask_name\": \"hd_wrinkle_output_periocular.png\"\n            },\n            \"nasolabial\": {\n                \"raw_score\": 74.03312683105469,\n                \"ui_score\": 74,\n                \"output_mask_name\": \"hd_wrinkle_output_nasolabial.png\"\n            },\n            \"marionette\": {\n                \"raw_score\": 71.94477319717407,\n                \"ui_score\": 73,\n                \"output_mask_name\": \"hd_wrinkle_output_marionette.png\"\n            },\n            \"whole\": {\n                \"raw_score\": 49.64699745178223,\n                \"ui_score\": 65,\n                \"output_mask_name\": \"hd_wrinkle_output_all.png\"\n            }\n        },\n        \"all\": {\n            \"score\": 75.75757575757575\n        },\n        \"skin_age\": 37\n    }\n    ```\n  * SD 护肤的 score_info.json 示例\n    ```json\n    {\n        \"wrinkle\": {\n            \"raw_score\": 36.09360456466675,\n            \"ui_score\": 60,\n            \"output_mask_name\": \"wrinkle_output.png\"\n        },\n        \"droopy_upper_eyelid\": {\n            \"raw_score\": 79.05348539352417,\n            \"ui_score\": 80,\n            \"output_mask_name\": \"droopy_upper_eyelid_output.png\"\n        },\n        \"droopy_lower_eyelid\": {\n            \"raw_score\": 79.97175455093384,\n            \"ui_score\": 81,\n            \"output_mask_name\": \"droopy_lower_eyelid_output.png\"\n        },\n        \"firmness\": {\n            \"raw_score\": 89.66898322105408,\n            \"ui_score\": 85,\n            \"output_mask_name\": \"firmness_output.png\"\n        },\n        \"acne\": {\n            \"raw_score\": 92.29713000000001,\n            \"ui_score\": 88,\n            \"output_mask_name\": \"acne_output.png\"\n        },\n        \"moisture\": {\n            \"raw_score\": 48.694559931755066,\n            \"ui_score\": 70,\n            \"output_mask_name\": \"moisture_output.png\"\n        },\n        \"eye_bag\": {\n            \"raw_score\": 76.67280435562134,\n            \"ui_score\": 79,\n            \"output_mask_name\": \"eye_bag_output.png\"\n        },\n        \"dark_circle_v2\": {\n            \"raw_score\": 80.1993191242218,\n            \"ui_score\": 76,\n            \"output_mask_name\": \"dark_circle_v2_output.png\"\n        },\n        \"age_spot\": {\n            \"raw_score\": 83.23274230957031,\n            \"ui_score\": 77,\n            \"output_mask_name\": \"age_spot_output.png\"\n        },\n        \"radiance\": {\n            \"raw_score\": 76.57244205474854,\n            \"ui_score\": 79,\n            \"output_mask_name\": \"radiance_output.png\"\n        },\n        \"redness\": {\n            \"raw_score\": 72.011962890625,\n            \"ui_score\": 77,\n            \"output_mask_name\": \"redness_output.png\"\n        },\n        \"oiliness\": {\n            \"raw_score\": 60.74365234375,\n            \"ui_score\": 72,\n            \"output_mask_name\": \"oiliness_output.png\"\n        },\n        \"pore\": {\n            \"raw_score\": 88.38014125823975,\n            \"ui_score\": 84,\n            \"output_mask_name\": \"pore_output.png\"\n        },\n        \"texture\": {\n            \"raw_score\": 80.09742498397827,\n            \"ui_score\": 76,\n            \"output_mask_name\": \"texture_output.png\"\n        },\n        \"all\": {\n            \"score\": 75.75757575757575\n        },\n        \"skin_age\": 37\n    }\n    ```\n\n## 文件规格与错误码\n* 支持的格式与尺寸\n\n| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |\n| ---- | ---- | ---- | ---- |\n| SD 护肤 | 短边长度至少 480 像素。 <br> 长边不限制；但超过 2560 像素时，系统会自动缩放到 2560 像素。 | < 10MB | jpg/jpeg/png |\n| HD 护肤 | 短边长度至少 1080 像素。 <br> 长边不限制；但超过 2560 像素时，会自动缩放到 2560 像素。 |< 10MB | jpg/jpeg/png |\n\n> **警告：** 接口会自动把图片缩放到最大 2560 像素，但请自行确保所有人脸清楚合焦、画质够高、光线均匀、人脸足够大且正对相机。拍摄 HD 或 SD 护肤图片、准备跑 AI 肤质分析之前，务必避开运动模糊与遮挡。为获得最佳效果，强烈建议采用竖幅（肖像）比例，不要横幅。\n\n* 拍摄建议：\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_AI%20Skin%20Analysis_camera_f93315b088.png)\n\n* 开始测肤前的准备说明\n* 摘下眼镜，确认刘海没有遮住额头\n* 确保您处在光线充足的环境中\n* 卸妆后再测，结果更准\n* 直视镜头，把脸保持在画面中央\n\n* 照片要求\n我们会检查图片质量，确认它适合跑 AI 肤质分析。请确保脸部约占图片宽度的 60–80%，没有任何叠加物或遮挡。光线要明亮且分布均匀，避免过曝与高光溢出。姿态须正对镜头、自然放松，嘴巴闭合、眼睛睁开。\n\n请完整露出额头，把刘海往后梳或把头发扎起来，保证质量最佳。建议摘下眼镜，AI 肤质分析表现更好，这一项不是强制要求。\n> **警告：** 脸部宽度需大于图片宽度的 60%。\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_AI%20Skin%20Analysis_error_src_face_too_small_cr_725792a7fb.png)\n\n\n* 错误码\n\n|错误码|说明|\n|  ----  | ----  |\n|error_below_min_image_size|输入图片分辨率过小|\n|error_exceed_max_image_size|输入图片分辨率过大|\n|error_src_face_too_small|上传图片中的脸部区域太小。脸部宽度需大于图片宽度的 60%。|\n|error_src_face_out_of_bound|上传图片中的脸部区域超出画面边界|\n|error_lighting_dark|上传图片的光线太暗|\n\n* 运行环境与依赖\n\n| 示例代码语言 / 工具 | 建议运行时版本 |\n|---|---|\n| cURL | - bash >= 3.2</br>   - curl >= 7.58 (modern TLS/HTTP support)</br>   - jq >= 1.6 (robust JSON parsing) |\n| Node.js (JavaScript) | Node >= 18 (for global fetch) |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |\n| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |\n\n---\n\n## 点数消耗\n\n\n* AI 肤质分析 V2.1\n\n| AI 功能 | SD | HD | 加购高级测肤报告 | 加购商品推荐 |\n|---|---|---|---|---|\n| 分析 1~4 项皮肤问题 | 9 | 12 | +15 点 | +10 点 |\n| 分析 5~8 项皮肤问题 | 12 | 16 | +25 点 | +15 点 |\n| 分析 9~12 项皮肤问题 | 14 | 20 | +35 点 | +20 点 |\n| 分析 13~16 项皮肤问题 | 16 | 22 | +40 点 | +25 点 |\n\n---\n\n## JS Camera Kit\n{% partial file=\"/_partials/js-camera-kit.md\" /%}\n\n---\n\n## Mobile Camera Kit\n{% partial file=\"/_partials/mobile-camera-kit.md\" /%}\n\n---\n\n## 使用场景\n\n**Base URL：** `https://yce-api-01.makeupar.com`\n**分析接口：** `POST /s2s/v2.1/task/skin-analysis`\n**鉴权：** `Authorization: Bearer YOUR_API_KEY` —— 请注意 `Bearer` 与密钥之间只有一个空格。\n\n```bash\nexport API_KEY=\"your-api-key\"\nexport BASE_URL=\"https://yce-api-01.makeupar.com\"\n```\n\n每种使用场景各自对应一个接口，按您需要哪些加购能力来选择：\n\n| 模式 | `advanced_report` | `product_recommendation` | `llm_results.json` 里能拿到什么 |\n|---|---|---|---|\n| **[AI 肤质分析（标准）](/reference/ai_skin_analysis/standard-analysis/endpoint-overview)** | 不传 | 不传 | 各检测维度的皮肤问题评分 |\n| **[AI 肤质分析 + 高级测肤报告](/reference/ai_skin_analysis/analysis-+-advanced-report/endpoint-overview)** | 传入 | 不传 | 评分，外加一份讲成因与护理建议的个性化报告 |\n| **[AI 肤质分析 + 商品推荐](/reference/ai_skin_analysis/analysis-+-product-recommendation/endpoint-overview)** | 不传 | 传入 | 评分，外加从您的商品目录里匹配出的商品 |\n| **[AI 肤质分析 + 高级测肤报告 + 商品推荐](/reference/ai_skin_analysis/analysis-+-report-+-recommendation/endpoint-overview)** | 传入 | 传入 | 一次调用同时拿到评分、报告与商品匹配结果 |\n\n> **说明：** 带加购能力的模式会在基础点数之外产生额外的点数消耗。详情请见 [点数消耗](/reference/ai_skin_analysis/section/overview/unit-consumption)。\n\n---\n"}},"baseSlug":"/zh-cn/reference/ai_skin_analysis","routesMapping":{}}