服飾分割
本文介紹分割摳圖(imageseg)類目下的服飾分割SegmentCloth的語法及示例。
功能描述
服飾分割能力可以對(duì)輸入人臺(tái)服飾、真人服飾、純服飾、虛擬人服飾等場(chǎng)景圖片中的主體服飾進(jìn)行像素級(jí)摳圖,并返回?fù)笀D結(jié)果。服飾分割主要是針對(duì)圖片中的服裝進(jìn)行精細(xì)化分割,服飾分割標(biāo)準(zhǔn)支持外套、上裝(含內(nèi)襯)、褲裝、裙裝、帽子、鞋子、包包品類分割,其他皮帶、領(lǐng)帶等裝飾品等內(nèi)容建議使用商品分割。
關(guān)于該接口功能的示例圖如下:
輸入原圖(左)和輸出結(jié)果圖(右)
- 識(shí)別出服飾類別為:tops(上衣)、skirt(裙裝)、shoes(鞋子)
- 識(shí)別出服飾類別為:tops(上衣)、pants(褲裝)、shoes(鞋子)、bag(包類)
- 識(shí)別出服飾類別為:hat(帽子)
您可以傳入ReturnForm參數(shù)指定返回結(jié)果形式:
- 指定為mask,返回二值遮罩圖。
- 指定為whiteBK,返回純白背景的白底圖。
- 不指定參數(shù),返回?zé)o背景的圖。
應(yīng)用場(chǎng)景
- 電商服飾分割:可對(duì)電商服飾圖片進(jìn)行前景分割處理,實(shí)現(xiàn)服飾的背景分離和替換,實(shí)現(xiàn)電商服飾主圖批量處理和制作。
- 虛擬試衣制作:在婚紗攝影、民族服飾、漢服、仿妝等虛擬試衣場(chǎng)景,通過圖片服飾前處理環(huán)節(jié)進(jìn)行服飾分割,再通過AIGC生成技術(shù)進(jìn)行換裝試穿。
- 個(gè)性化智能識(shí)別:可針對(duì)圖片中的外套、上裝(含內(nèi)襯)、褲裝、裙裝、帽子、鞋子、包包品類指定類別mask進(jìn)行分割處理返回,實(shí)現(xiàn)指定個(gè)性化服飾類型摳圖處理。
特點(diǎn)優(yōu)勢(shì)
- 多類型自動(dòng)識(shí)別:自動(dòng)識(shí)別出圖像中的主體服飾,不需要額外指定服裝位置,可返回指定類別mask。
- 適用多服飾場(chǎng)景:適用于人臺(tái)服飾、真人服飾、純服飾、虛擬人服飾等精細(xì)化摳圖場(chǎng)景。
- 復(fù)雜全類目分割:適合多服飾商品以及復(fù)雜背景條件下的服飾主體分割,實(shí)現(xiàn)精細(xì)化全類目分割。
接入指引
1. 注冊(cè)阿里云賬號(hào):打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊(cè),按照操作提示完成賬號(hào)注冊(cè)。
2. 開通能力:請(qǐng)確保您已開通分割摳圖服務(wù),若未開通服務(wù)請(qǐng)立即開通。
3. 創(chuàng)建AccessKey:請(qǐng)確保您已創(chuàng)建AccessKey,如果您使用的是子賬號(hào)AccessKey,您需要給子賬號(hào)賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請(qǐng)參見RAM授權(quán)。
4. 在線調(diào)試(可選):您可以通過OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對(duì)應(yīng)語言的SDK文檔中找到AI類目為分割摳圖(imageseg)的SDK包進(jìn)行安裝。
- 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。
6. 示例代碼:該能力常用語言的示例代碼,請(qǐng)參見服飾分割示例代碼。
7. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。
輸入限制
- 圖像格式:PNG、JPEG、JPG、BMP。
- 圖像大小:不超過3 MB。
- 圖像分辨率:大于50×50像素,且小于3000×3000像素。
- URL地址中不能包含中文字符。
計(jì)費(fèi)說明
關(guān)于服飾分割的計(jì)費(fèi)方式及報(bào)價(jià),請(qǐng)參見計(jì)費(fèi)介紹。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | SegmentCloth | 系統(tǒng)規(guī)定參數(shù)。取值:SegmentCloth。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCloth/SegmentCloth1.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對(duì)于文件在本地或者非上海地域OSS鏈接的情況,請(qǐng)參見文件URL處理。 |
OutMode | Long | 否 | 0或1 | 返回分割結(jié)果的類型,影響ImageURL字段的返回內(nèi)容,用戶非必選。
|
ClothClass.N | String | 否 | tops | 服飾類別。可一次傳入多個(gè)值。取值范圍:
|
ReturnForm | String | 否 | whiteBK | 指定返回的圖像格式,取值范圍:
|
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | BCE049A3-FE69-41CF-A870-5970156388A7 | 請(qǐng)求ID。 |
Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
Elements | Array of Element | 返回元素的數(shù)組。 |
|
ImageURL | String | http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/clothingsegmentation-2020-06-17-16-54-40-688c84cbbd-hnqfq/2020-6-18/invi__015924459307821000041_IIVHoM.png?Expires=1592447730&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hy8pn3IQj8nuKN0LEaC57cee9L**** | 返回?fù)笀D結(jié)果圖像URL地址。 摳圖之后返回四通道PNG圖,無壓縮,圖像尺寸保持不變,圖像體積會(huì)變大。 說明 該URL地址為臨時(shí)地址,有效期為30分鐘,過期后將無法訪問。若需要長(zhǎng)時(shí)間或者永久保存文件,請(qǐng)?jiān)?0分鐘內(nèi)訪問URL地址,下載文件轉(zhuǎn)存到自己的OSS或者其他存儲(chǔ)空間。 |
ClassUrl | Map | 根據(jù)用戶輸入的 說明 該URL地址為臨時(shí)地址,有效期為30分鐘,過期后將無法訪問。若需要長(zhǎng)時(shí)間或者永久保存文件,請(qǐng)?jiān)?0分鐘內(nèi)訪問URL地址,下載文件轉(zhuǎn)存到自己的OSS或者其他存儲(chǔ)空間。 |
|
String | {'tops':http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/..,'hat':http://viapi-cn-shanghai-dha-segmenter...,...} | 根據(jù)用戶輸入的 說明 該URL地址為臨時(shí)地址,有效期為30分鐘,過期后將無法訪問。若需要長(zhǎng)時(shí)間或者永久保存文件,請(qǐng)?jiān)?0分鐘內(nèi)訪問URL地址,下載文件轉(zhuǎn)存到自己的OSS或者其他存儲(chǔ)空間。 |
SDK參考
阿里云視覺AI分割摳圖類目下的服飾分割能力推薦使用SDK調(diào)用,支持多種編程語言,調(diào)用時(shí)請(qǐng)選擇AI類目為分割摳圖(imageseg)的SDK包,文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請(qǐng)參見服飾分割示例代碼。
示例
請(qǐng)求示例
http(s)://imageseg.cn-shanghai.aliyuncs.com/?Action=SegmentCloth //更多關(guān)于訪問域名(Endpoint)信息,請(qǐng)參見:http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCloth/SegmentCloth1.jpg
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SegmentClothResponse>
<RequestId>BCE049A3-FE69-41CF-A870-5970156388A7</RequestId>
<Data>
<Elements>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/clothingsegmentation-2020-06-17-16-54-40-688c84cbbd-hnqfq/2020-6-18/invi__015924459307821000041_IIVHoM.png?Expires=1592447730&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hy8pn3IQj8nuKN0LEaC57cee9L****</ImageURL>
<ClassUrl>
<key>{'tops':http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/..,'hat':http://viapi-cn-shanghai-dha-segmenter...,...}</key>
</ClassUrl>
</Elements>
</Data>
</SegmentClothResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "BCE049A3-FE69-41CF-A870-5970156388A7",
"Data" : {
"Elements" : [ {
"ImageURL" : "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/clothingsegmentation-2020-06-17-16-54-40-688c84cbbd-hnqfq/2020-6-18/invi__015924459307821000041_IIVHoM.png?Expires=1592447730&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hy8pn3IQj8nuKN0LEaC57cee9L****",
"ClassUrl" : {
"key" : "{'tops':http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/..,'hat':http://viapi-cn-shanghai-dha-segmenter...,...}"
}
} ]
}
}
錯(cuò)誤碼
關(guān)于服飾分割的錯(cuò)誤碼,詳情請(qǐng)參見常見錯(cuò)誤碼。
安全聲明
- 請(qǐng)確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
- 通過體驗(yàn)調(diào)試上傳的臨時(shí)文件有效期為1小時(shí),在24小時(shí)后會(huì)被系統(tǒng)自動(dòng)清理刪除。