跳转到内容
/V1.0

V1.0

使用 AI 處理，在上傳的圖片模擬肌膚質地變化（皺紋、光澤、油脂等）。

操作

執行 AI 膚況模擬任務。

请求

這個端點啟動膚況模擬流程。您必須提供來源檔案（透過網址或檔案 ID），並指定模擬參數（皺紋、光澤等）。至少有一個參數不能為零。任務會以非同步方式處理，您可以使用這個回應回傳的 task_id 查詢其狀態。

安全
BearerAuthenticationV2
正文application/json必需

模擬強度不可全為零。

Any of:
wrinklenumber, [ 0 .. 1 ]

減少皺紋與細紋的外觀，同時恢復更平滑、更緊實、明顯回春與年輕的肌膚。
0.0 為原始肌膚，1.0 為去除最多皺紋的肌膚。

示例:1
radiancenumber, [ 0 .. 1 ]

提升肌膚光澤與明亮度，展現清新、充滿活力的光采與更明亮、更有光澤的膚色。
0.0 為原始肌膚亮度，1.0 為最大光澤／發光的肌膚。

示例:1
oilinessnumber, [ 0 .. 1 ]

控制多餘的油光，呈現清新、乾淨、無油光的膚色，帶來平衡且舒適的霧面感。
0.0 為原始肌膚，1.0 為加入最多油脂／油光的肌膚。

示例:1
acnenumber, [ 0 .. 1 ]

透過減少痘痘與黑頭粉刺，淨化易長粉刺的肌膚，呈現更平滑、細緻、明顯無瑕且光澤的膚色。
0.0 為原始肌膚，1.0 為去除最多痤瘡／粉刺的肌膚。

示例:1
eye_bagsnumber, [ 0 .. 1 ]

明顯減少眼下浮腫，恢復更平滑、更緊實、更有精神、充分休息的外觀。
0.0 為原始眼下外觀，1.0 為去除最多眼袋。

示例:1
dark_circlenumber, [ 0 .. 1 ]

明顯減淡黑眼圈，呈現更明亮、充分休息的眼周，外觀清新且有光澤。
0.0 為原始眼下顏色，1.0 為去除最多黑眼圈。

示例:1
spotsnumber, [ 0 .. 1 ]

針對老化斑並明顯淡化，同時提升肌膚清晰度，呈現更平滑、更均勻的年輕光采。
0.0 為原始肌膚，1.0 為去除最多老化斑／瑕疵。

示例:1
poresnumber, [ 0 .. 1 ]

細緻並明顯縮小粗大毛孔，呈現更平滑、更精緻、完美細緻的肌膚。
0.0 為原始毛孔可見度，1.0 為最細緻／幾乎看不見的毛孔。

示例:1
texturenumber, [ 0 .. 1 ]

將肌膚質地精修至高級訂製級的平滑度，明顯改善不平處，呈現絲滑、完美打磨且光澤的膚色。
0.0 為原始肌膚質地，1.0 為最平滑的肌膚質地。

示例:1
rednessnumber, [ 0 .. 1 ]

明顯減少泛紅、舒緩易患酒糟性皮膚炎的區域，恢復更清澈、更均勻、舒適精修的膚色，讓敏感肌膚平靜並重新平衡。
0.0 為原始膚色，1.0 為去除最多泛紅／刺激。

示例:1
src_file_urlstring必需

要執行任務的檔案網址。該網址應可公開存取。

示例:"https://example.com/selfie.jpg"
curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-simulation \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg",
    "wrinkle": 1,
    "radiance": 1,
    "oiliness": 1,
    "acne": 1,
    "eye_bags": 1,
    "dark_circle": 1,
    "spots": 1,
    "pores": 1,
    "texture": 1,
    "redness": 1
  }'

响应

任務執行成功

正文application/json
statusinteger

回應狀態

示例:200
dataobject
响应
{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}