V1.0

執行染髮任務。

请求

這個端點啟動染髮流程。您必須提供來源檔案（透過網址或檔案 ID），並指定色彩設定（preset、pattern 或 palettes）。任務會以非同步方式處理，您可以使用這個回應回傳的 task_id 查詢其狀態。

安全

BearerAuthenticationV2

正文application/json必需

Any of:

這個物件代表一個執行 AI 虛擬染髮任務。

presetstring

（選填；若未提供 "pattern" 與 "palettes"，則為必要）預設髮色預設值。全染模式可用：['Jet Black'（Jet Black）, 'Chocolate Brown'（巧克力棕）, 'Honey Blonde'（蜂蜜金）, 'Platinum Blonde'（鉑金）, 'Ash Gray'（灰）, 'Rose Gold'（玫瑰金）, 'Burgundy'（酒紅）, 'Copper Red'（銅紅）, 'Lavender'（薰衣草紫）, 'Teal Blue'（藍綠）] 漸層模式可用：['Dark Brown/Caramel Blonde'（深棕/焦糖金）, 'Jet Black/Silver Gray'（Jet Black/銀灰）, 'Ash Brown/Lavender'（灰棕/薰衣草紫）, 'Rose Gold/Peach Blonde'（玫瑰金/桃金）, 'Burgundy/Magenta Pink'（酒紅/洋紅粉）, 'Deep Blue/Teal Green'（深藍/藍綠）, 'Plum Purple/Pastel Lilac'（梅紫/淡紫）, 'Copper Red/Golden Blonde'（銅紅/金棕）, 'Dark Gray/Ice Blonde'（深灰/冰金）, 'Midnight Blue/Denim Blue'（午夜藍/丹寧藍）]

Enum:"Jet Black""Chocolate Brown""Honey Blonde""Platinum Blonde""Ash Gray""Rose Gold""Burgundy""Copper Red""Lavender""Teal Blue"

patternobject

（選填；若未提供 "preset" 則為必要）

palettesArray of objects, [ 1 .. 2 ] items

（選填；若未提供 "preset" 則為必要）陣列長度在全染模式為 1，在漸層模式為 2

src_file_urlstring必需

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

示例:"https://example.com/selfie.jpg"

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/hair-color \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg",
    "preset": "Jet Black",
    "pattern": {
      "name": "ombre",
      "blend_strength": 0,
      "line_offset": -0.99,
      "coloring_section": "top"
    },
    "palettes": [
      {
        "color": "string",
        "color_intensity": 0,
        "shine_intensity": 0
      }
    ]
  }'

响应

染髮任務執行成功

正文application/json

statusinteger

回應狀態

示例:200

dataobject

响应

{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}

V1.0

執行染髮任務。

请求

响应

这有帮助吗？