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

交互式涂抹分割

更新时间：
产品详情
我的收藏

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

服务说明

由于产品业务调整，交互式涂抹分割服务将于2025年08月14日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2025年10月14日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对交互式涂抹分割API服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

功能描述

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

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

  • 输入原图
  • 涂抹操作
  • 分割mask
  • 分割结果
说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

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

特色优势

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

输入限制

  • 图像格式：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=LTAI****************&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=LTAI****************&amp;Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****</ResultUrl>
    </Data>
</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=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****"
  }
}

错误码

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

安全声明

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

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