本文介紹分割摳圖（imageseg）類目下的人體分割SegmentBody的語法及示例。

功能描述

人體分割能力用于識別輸入圖像中的人體輪廓，與背景進(jìn)行分離，返回分割后的前景人像圖（4通道）。本功能適用于真人圖片，不適用于卡通圖片。

關(guān)于該接口功能的示例圖如下：

  • 輸入原圖
  • 輸出結(jié)果圖（默認(rèn)為4通道透明圖，和原圖分辨率保持一致）

您可以傳入ReturnForm參數(shù)指定返回結(jié)果形式：

  • 指定為crop，對邊緣空白區(qū)域進(jìn)行裁剪
  • 指定為mask，返回二值遮罩圖
  • 指定為whiteBK，返回純白背景的白底圖
說明
  • 您可以進(jìn)入在線咨詢獲取在線人工幫助。
  • 當(dāng)前能力可在視覺智能開放平臺有完整的免費產(chǎn)品體驗，您可以單擊立即試用對該能力進(jìn)行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。

應(yīng)用場景

  • 人像攝影：人體分割通過將攝影主體人物從背景中分割出來，將背景虛化，以達(dá)到大光圈淺景深效果，突出人物主體。
  • 證件照制作：上傳或拍攝一張生活照，可將人物精細(xì)地分割出來，再搭配其他背景處理能力，最終制作出標(biāo)準(zhǔn)的證件照。

特色優(yōu)勢

  • 發(fā)絲級精細(xì)分割：在細(xì)碎部位提供更高的分割精度，細(xì)到發(fā)絲都能被精確分割，使結(jié)果圖像沒有違和感，難以被覺察出經(jīng)過處理。
  • 適應(yīng)復(fù)雜背景：即使人物處于復(fù)雜背景環(huán)境，依然可以將人體準(zhǔn)確地從背景中分割出來。

接入指引

1. 注冊阿里云賬號：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通分割摳圖服務(wù)，若未開通服務(wù)請立即開通。

3. 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限，具體操作，請參見RAM授權(quán)。

4. 在線調(diào)試（可選）：您可以通過OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發(fā)接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應(yīng)語言的SDK文檔中找到AI類目為分割摳圖（imageseg）的SDK包進(jìn)行安裝。
  • 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。

6. 示例代碼：該能力常用語言的示例代碼及常見結(jié)果后續(xù)處理示例，請參見人體分割示例代碼。

7. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。

輸入限制

  • 圖像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。
  • 圖像大小：不超過3 MB。
  • 圖像分辨率：小于2000×2000像素。
  • URL地址中不能包含中文字符。

計費說明

關(guān)于人體分割的計費方式及報價，請參見計費介紹。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 SegmentBody

系統(tǒng)規(guī)定參數(shù)。取值：SegmentBody。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentBody/SegmentBody1.png

圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

圖片格式要求：

  • 圖像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。
  • 圖像大小：不超過3 MB。
  • 圖像分辨率：小于2000×2000像素。
  • URL地址中不能包含中文字符。
ReturnForm String 否 mask

指定返回的圖像形式。

  • 如果設(shè)置為mask，則返回單通道黑白圖。
  • 如果設(shè)置為crop，則返回裁剪之后的四通道PNG圖（裁掉邊緣空白區(qū)域）。
  • 如果設(shè)置為whiteBK，則返回白底圖。
  • 如果不設(shè)置或者設(shè)置為其他值，則返回四通道PNG圖。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String 30EDCEEA-2806-44C6-AF0B-0988849106FE

請求ID。
Data Object

返回的結(jié)果數(shù)據(jù)內(nèi)容。
ImageURL String http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-31/invi_humansegmenter_016171823500001081370_Ej0WwO.jpg?Expires=1617184150&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=ZwaWXpAOMzHar%2B1wVO7zeSD83r****

結(jié)果圖像URL地址。

請求參數(shù)指定返回的圖像形式。

  • 如果設(shè)置為mask，則返回單通道黑白圖。
  • 如果設(shè)置為crop，則返回裁剪之后的四通道PNG圖（裁掉邊緣空白區(qū)域）。
  • 如果設(shè)置為whiteBK，則返回白底圖。
  • 如果不設(shè)置或者設(shè)置為其他值，則返回四通道PNG圖，無壓縮，圖像尺寸保持不變，圖像體積會變大。
說明 該URL地址為臨時地址，有效期為30分鐘，過期后將無法訪問。若需要長時間或者永久保存文件，請在30分鐘內(nèi)訪問URL地址，下載文件轉(zhuǎn)存到自己的OSS或者其他存儲空間。

SDK參考

阿里云視覺AI分割摳圖類目下的人體分割能力推薦使用SDK調(diào)用，支持多種編程語言，調(diào)用時請選擇AI類目為分割摳圖（imageseg）的SDK包，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼及最佳實踐

該能力常用語言的示例代碼及常見結(jié)果后續(xù)處理示例，請參見人體分割示例代碼。

示例

請求示例

http(s)://imageseg.cn-shanghai.aliyuncs.com/?Action=SegmentBody      //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentBody/SegmentBody1.png
&ReturnForm=mask
&公共請求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SegmentBodyResponse>
    <RequestId>30EDCEEA-2806-44C6-AF0B-0988849106FE</RequestId>
    <Data>
        <ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-31/invi_humansegmenter_016171823500001081370_Ej0WwO.jpg?Expires=1617184150&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=ZwaWXpAOMzHar%2B1wVO7zeSD83r****</ImageURL>
    </Data>
</SegmentBodyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "30EDCEEA-2806-44C6-AF0B-0988849106FE",
  "Data" : {
    "ImageURL" : "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-31/invi_humansegmenter_016171823500001081370_Ej0WwO.jpg?Expires=1617184150&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=ZwaWXpAOMzHar%2B1wVO7zeSD83r****"
  }
}

錯誤碼

關(guān)于人體分割的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
  • 通過體驗調(diào)試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。