AI 助理
备案控制台
文档
输入文档关键字查找
首页 视觉智能开放平台 开发参考 API参考 创新专区 交互式涂抹分割

交互式涂抹分割

更新时间：
产品详情
相关技术圈
我的收藏

本文介绍创新专区（aigen）类目下的交互式涂抹分割InteractiveScribbleSegmentation的语法及示例。

功能描述

交互式涂抹分割能力支持用户通过鼠标涂抹的方式选择目标元素，算法模型通过涂抹区域的位置和大小，自动对涂抹的目标进行分割。

关于该接口功能的示例图如下：

  • 输入原图
  • 涂抹操作
  • 分割mask
  • 分割结果
说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

图片编辑：可对图像中的任意涂抹元素进行选择并智能分离，实现图像后续的二次编辑。

特色优势

  • 图片元素识别：根据涂抹区域的位置和大小，自动对涂抹目标进行识别和分割。
  • 自由开放选择：允许用户通过鼠标涂抹操作自由选择和排除所需的分割对象。
  • 适用多种场景：适用于人、动物、食物、物品、家居等各种抠图场景，使用范围广。

接入指引

1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。

2. 开通能力：请确保您已开通创新专区服务，若未开通服务请立即开通。

3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。

4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。

5. 开发接入步骤：

  • 在SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为创新专区（aigen）的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 示例代码：该能力常用语言的示例代码，请参见交互式涂抹分割示例代码。

7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

输入限制

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过10 MB。
  • 输入图像：大于等于32x32像素，小于等于4096x4096像素。
  • URL地址中不能包含中文字符。

计费说明

交互式涂抹分割能力目前处于公测期，可免费调用。

调试

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

请求参数

名称

类型

是否必选

示例值

描述
Action String 是 InteractiveScribbleSegmentation

系统规定参数。取值：InteractiveScribbleSegmentation。
ImageUrl String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx01.png

输入的图像URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。输入限制如下：

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过10 MB。
  • 输入图像：大于等于32x32像素，小于等于4096x4096像素。
  • URL地址中不能包含中文字符。
MaskImageUrl String 否 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx02.png

输入的Mask URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。输入限制如下：

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过5 MB。
  • 输入图像：大于等于32x32像素，并与输入原图分辨率保持一致。
PosScribbleImageUrl String 否 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx03.png

正向涂抹轨迹图像URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。输入限制如下：

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过5 MB。
  • 输入图像：大于等于32x32像素，小于等于4096x4096像素，并与输入原图分辨率保持一致。
NegScribbleImageUrl String 否 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx04.png

负向涂抹轨迹图像URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。输入限制如下：

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过5 MB。
  • 输入图像：大于等于32x32像素，小于等于4096x4096像素，并与输入原图分辨率保持一致。
IntegratedMaskUrl String 否 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx05.png

整合的Mask URL。将初始mask、正向划线记录、负向划线记录分别放在rgb图像的三个通道，合成一个图片，减少传输的图片数量，从而节省上传下载时间。输入限制如下：

  • 图像格式：JPG、JPEG、PNG、BMP、WEBP。
  • 图像大小：不超过5 MB。
  • 输入图像：大于等于32x32像素，小于等于4096x4096像素，并与输入原图分辨率保持一致。
ReturnForm String 否 only_alpha

输出图像形式。取值范围如下：

  • rgb_alpha（默认）：返回四通道PNG图，即透明底图。
  • only_alpha：返回单通道mask。
  • white_background：返回白底图。
ReturnFormat String 否 PNG

输出图像格式。支持JPG、PNG，默认为PNG。
EdgeFeathering String 否 true

是否做边缘羽化。默认值为true。
PostprocessOption String 否 edgerefine

选择mask精细化模型。取值范围如下：

  • edgerefine：稳定但精细度稍微差一点。
  • maskrefine（默认）：精细度高但不够稳定。

返回数据

名称

类型

示例值

描述
RequestId String 7574ee8f-38a3-4b1e-9280-11c33ab46e51

请求ID。
Data Object

返回的结果数据内容。
ResultUrl String https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****

输出图片的URL，格式由请求参数确定。

说明 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。

参数可视化说明

功能一：正向涂抹分割

示例：输入原图、当前mask、正向涂抹记录，输出正向分割结果。

功能二：负向涂抹分割

输入原图、当前mask、负向涂抹记录，输出负向分割结果。

SDK参考

阿里云视觉AI创新专区类目下的交互式涂抹分割能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为创新专区（aigen）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例代码

该能力常用语言的示例代码，请参见交互式涂抹分割示例代码。

示例

请求示例

http(s)://aigen.cn-shanghai.aliyuncs.com/?Action=InteractiveScribbleSegmentation      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx01.png
&MaskImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx02.png
&PosScribbleImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx03.png
&NegScribbleImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx04.png
&IntegratedMaskUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx05.png
&ReturnForm=only_alpha
&ReturnFormat=PNG
&EdgeFeathering=true
&PostprocessOption=edgerefine
&公共请求参数

正常返回示例

XML格式

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

<InteractiveScribbleSegmentationResponse>
    <RequestId>7574ee8f-38a3-4b1e-9280-11c33ab46e51</RequestId>
    <Data>
        <ResultUrl>https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&amp;Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****</ResultUrl>
    </Data>
    <Message>-</Message>
</InteractiveScribbleSegmentationResponse>

JSON格式

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

{
  "RequestId" : "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "Data" : {
    "ResultUrl" : "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****"
  },
  "Message" : "-"
}

错误码

关于交互式涂抹分割的错误码，具体请参见常见错误码。

安全声明

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

上一篇：创新专区介绍下一篇：交互式全图分割
文档推荐