本文介绍食品分割SegmentFood的语法及示例。

功能描述

食品分割用于对图片中的食品进行像素级抠图，并返回抠图结果。

应用场景

  • 餐厅菜单：拍摄实物菜品后，通过食品分割，即可将菜品从杂乱背景中抠出，添加到菜单中。
  • 美食广告：在餐饮业推广宣传中，将美食照片抠图后再加工处理成广告素材。

特色优势

适应范围广：适合大部分中西式菜品、面包、蛋糕点心等自动抠图。

前提条件

请确保您已开通分割抠图服务，若未开通服务请立即开通。

输入限制

  • 图像格式：PNG、JPEG、JPG、BMP。
  • 图像大小：不超过4 MB。
  • 图像分辨率：大于40×40像素，小于1999×1999像素。
  • URL地址中不能包含中文字符。

计费说明

关于食品分割的计费方式及报价，请参见计费介绍。

说明 下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SegmentFood

系统规定参数。取值：SegmentFood。

ImageURL String 是 http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/foodsegmenter-image/5.jpeg

图像URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

ReturnForm String 否 mask

指定返回的图像形式。

  • 如果不设置，则返回四通道png图。
  • 如果设置为mask，则返回单通道mask。
  • 如果设置为whiteBK，则返回白底图。

返回数据

名称 类型 示例值 描述
RequestId String 38265D08-AD0F-4752-8E96-D1D9FB96C3D9

请求ID。
Data Object

返回的结果数据内容。
ImageURL String http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/foodsegmenter-2020-06-17-15-24-00-8658fc85b8-8ds8k/2020-6-18/invi__015924442076191000002_WqJ99N.png?Expires=1592446007&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=5ITSd6ndSuP7pUfoDFpgLPUOGg****

返回抠图结果图片URL地址。

示例

请求示例

http(s)://[Endpoint]/?Action=SegmentFood
&ImageURL=http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/foodsegmenter-image/5.jpeg
&<公共请求参数>

正常返回示例

XML格式 

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

<RequestId>38265D08-AD0F-4752-8E96-D1D9FB96C3D9</RequestId>
<Data>
    <ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/foodsegmenter-2020-06-17-15-24-00-8658fc85b8-8ds8k/2020-6-18/invi__015924442076191000002_WqJ99N.png?Expires=1592446007&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=5ITSd6ndSuP7pUfoDFpgLPUOGg****</ImageURL>
</Data>

JSON格式 

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

{
  "RequestId" : "38265D08-AD0F-4752-8E96-D1D9FB96C3D9",
  "Data" : {
    "ImageURL" : "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/foodsegmenter-2020-06-17-15-24-00-8658fc85b8-8ds8k/2020-6-18/invi__015924442076191000002_WqJ99N.png?Expires=1592446007&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=5ITSd6ndSuP7pUfoDFpgLPUOGg****"
  }
}

错误码

关于食品分割的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。