AI 試衣-圖片分割是一個輔助模型，支援從模特圖或 AI 試衣圖中分割出服裝地區，如上裝、下裝、連衣裙或連體衣。此模型為可選模型，與 AI 試衣模型配合使用，可實現局部試衣、擷取指定服飾座標等特定效果。
本文檔僅適用於“中國大陸（北京）”地區。如需使用模型，需使用“中國大陸（北京）”地區的API Key。
模型概覽
模型名稱 | 計費單價 | 限流（主帳號與RAM子帳號共用） | |
任務下發介面RPS限制 | 同時處理中任務數量 | ||
aitryon-parsing-v1 | $0.000574/張 | 10 | 無限制 (同步介面) |
核心輸出圖解
調用本 API 後，您將獲得三個核心參數輸出。下面以“分割一件上衣”為例，展示了每個參數的含義和用途。
輸入 | 輸出 | ||
輸出參數 | 可視化樣本 | 含義及用途 | |
"clothes_type": ["upper"] | crop_img_url |
|
|
parsing_img_url |
|
| |
bbox | bbox值：[[331, 239,641,637]]
此圖展示 bbox 值與原圖座標的對應關係，並非模型輸出。 |
| |
使用情境
情境一：局部試衣
目標：替換模特的部分服飾（上裝或下裝），保留另一部分衣物不變。此情境需要先分割模特圖。
樣本：保留模特上裝，替換下裝
分割模特圖，提取上衣
調用本文的圖片分割 API，輸入原始模特圖，設定參數 clothes_type 為 ["upper"]，提模數特上衣。
API 返回包含上衣的服飾圖（ crop_img_url）。
輸入：模特圖
輸出：分割後的服飾圖（crop_img_url）
試衣圖片產生
調用 AI試衣-Plus版;
輸入模特圖、服飾上裝圖（由分割獲得）、服飾下裝圖，獲得最終的試衣效果圖。
輸入
輸出：試衣效果圖
模特圖
服飾上裝圖
服飾下裝圖
與圖片分割API輸入保持一致模特圖
圖片分割API的出參crop_img_url
需替換的服飾圖
情境二：擷取指定服飾的座標
目標：在模特圖或AI試衣效果圖上，擷取指定服飾的邊界框（bbox）座標。這些座標可用於添加商品標籤或建立互動熱區。
樣本：擷取上衣的座標
準備輸入圖片：輸入圖片可為 模特圖 或 AI試衣產生的效果圖。輸入映像要求請參見模特圖要求。
分割圖片，擷取座標：設定輸入圖片的分割類型，例如，設為 ["upper"] 分割並定位上衣，獲得所需區域的bbox。
輸入：模特圖或試衣效果圖
輸出：分割後的服飾圖和座標範圍
入參"clothes_type": ["upper"]
parsing_img_url：可視化分割結果的 URL。
bbox：該分割地區的邊界框座標，例如，[[331, 239,641,637]]。
前提條件
AI試衣-圖片分割API僅支援通過HTTP進行調用。
HTTP調用
請求介面
POST https://dashscope.aliyuncs.com/api/v1/services/vision/image-process/process入參描述
欄位 | 類型 | 傳參方式 | 必選 | 描述 | 樣本值 |
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。
模特圖樣本請詳見模特圖要求。 | http://a/a.jpg |
parameters.clothes_type | List[String] | Body | 否 | 指定需要分割類型。預設為 ["upper"]（上裝）。 列表的長度和順序決定了輸出結果中 URL 列表的長度和順序。 可選值為：
| ["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 |
請求樣本
分割模特圖的上裝
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/vision/image-process/process' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
"model": "aitryon-parsing-v1",
"input": {
"image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250630/bakbqz/aitryon_parse_model.png"
},
"parameters": {
"clothes_type": ["upper"]
}
}'響應樣本
成功響應（存在對應類型服飾）
parsing_img_url和crop_img_url有效期間為24小時，請及時下載。
{
"output": {
"bbox": [[331, 239,641,637]],
"parsing_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_parsing_img.png?Expires=xxxx"],
"crop_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_crop_img.jpg?Expires=xxxx"]
},
"usage": {
"image_count": 1
},
"request_id": "b68147d6-e7d0-920f-b889-xxxxxx"
}成功響應（不存在對應類型服飾）
{
"output":{
"bbox":[null],
"parsing_img_url":[null],
"crop_img_url":[null]
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}失敗響應
{
"request_id": "1d075a37-3768-9bc9-b781-xxxx",
"code": "InvalidParameter.ClothesType",
"message": "The request parameter is invalid, please check the request parameter."
}錯誤碼
大模型服務平台通用狀態代碼請查閱：錯誤資訊。