AI試衣-圖片分割API參考

aitryon-parsing-v1

$0.000574/張

10

無限制 (同步介面)

• 輸入模特圖
• 選擇服飾類型為上衣

"clothes_type": ["upper"]

• 分割後的服飾圖（RGB）：本樣本為穿著上衣的模特服飾圖。
• 作為 AI 試衣模型的輸入參數，用於局部試衣情境。
• URL有效期間為24小時，請及時下載並儲存。

• 分割後的服飾圖（RGBA）：本樣本為分割出來的上衣圖。
• 用於效果預覽，直觀驗證分割結果是否準確。
• URL有效期間為24小時，請及時下載並儲存。

此圖展示 bbox 值與原圖座標的對應關係，並非模型輸出。

• 邊界框（bounding box）：分割後的服飾圖（parsing_img_url）在輸入模特圖中的矩形地區座標。
  • bbox數組的元素格式為 [x1, y1, x2, y2]，代表邊界框的左上方和右下角座標。
  • 座標原點 (0,0) 為輸入模特圖的左上方。
• 用於實現前端互動功能（如商品熱區）。

Content-Type

String

Header

是

請求類型：application/json。

application/json

Authorization

String

Header

是

API-Key，格式為 Bearer sk-xxxx。

Bearer sk-xxxx

model

String

Body

是

指定調用的模型，固定為aitryon-parsing-v1。

aitryon-parsing-v1

input.image_url

String

Body

是

待分割的模特圖公網 URL。 您也可在此擷取臨時公網URL。

• 5KB≤影像檔≤5M

• 150≤映像邊長≤4096

• 格式支援：jpg、png、jpeg、bmp、heic

• 需保持圖片中有且僅有一個完整的人

• 僅支援HTTP/HTTPS連結，不支援本地路徑

模特圖樣本請詳見模特圖要求。

http://a/a.jpg

parameters.clothes_type

List[String]

Body

否

指定需要分割類型。預設為 ["upper"]（上裝）。

列表的長度和順序決定了輸出結果中 URL 列表的長度和順序。

可選值為：

• ["upper"]：表示分割上裝。

• ["lower"]：表示分割下裝。

• ["dress"]：表示連衣裙或連體衣或全身穿搭。

• ["upper", "lower"]：表示分割上裝和下裝。

["upper"]

output.parsing_img_url

List[String]

分割地區的可視化圖片 URL 列表。

長度和順序與入參 clothes_type 保持一致。如果未檢測到對應服飾，則該位置為 None/null。

圖片通道數為RGBA，儲存為PNG格式，

["http://a/a.png"]

[null] 或者 [None]

output.crop_img_url

List[String]

分割出的服飾圖片 URL 列表。

長度和順序與入參 clothes_type 保持一致。如果未找到對應服飾，則該位置為 None/null。

圖片為RGB格式。

["http://a/a.png"]

[null] 或者 [None]

output.bbox

List[Integer]

分割地區在原圖中位置的座標列表。

按照入參 clothes_type 中指定分割的地區順序排序。

每個bbox定義為 [x1, y1, x2, y2]，以輸入原圖的左上方為座標原點，分別代表左上方和右下角的座標。

[[10,20,30,40], [50,60,70,80]]

usage.image_count

Integer

本次請求檢測的圖片張數。

1

request_id

String

本次請求的唯一 ID。

7574ee8f-38a3-4b1e-9280-11c33ab46e51