ErasePerson_视觉智能开放平台-图像生产_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

图像人体擦除能力可以擦除图像中指定区域的人像,并自动填充背景。

说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 旅行照片修复:图像人体擦除可以帮您去除背景中的路人,还您美美的旅行照片。
    • 穿帮镜头后期修复:在影视拍摄过程中,如果在前期拍摄镜头中出现了本不应该出现的人物,可以通过图像人体擦除帮您批量处理修复这些穿帮镜头。

    特点优势

    • 尽量保留原照片内容:通过指定区域 Mask,缩小自动填充背景范围,擦除背景人物,降低处理后照片的违和感。人像区域 mask,建议使用阿里云视觉智能开放平台提供的人体分割算法来获得,可以得到更好的效果。
    • 自动生成填充被人体遮挡的背景:基于深度学习算法,图像人体擦除可以推理还原出被人体遮挡的背景内容,真实而没有违和感。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
    2. 开通能力:请确保您已开通图像生产服务,若未开通服务请立即开通
    3. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权
    4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
    5. 开发接入步骤:
    • SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为图像生产(imageenhan)的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。
    1. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

    • 图像格式:JPG、JPEG、BMP、PNG、WEBP、TIF。
    • 图像大小:不超过 3 MB。
    • 图像分辨率:大于 5×5 像素,小于 2048×2048 像素。
    • URL 地址中不能包含中文字符。
    • 图像中指定区域应尽量贴合人形,可以用矩形、多边形、不规则区域表示。需要擦除的区域面积不能超过整体图像的 25%。

    计费说明

    关于图像人体擦除的计费方式及报价,请参见计费介绍

    说明 下方调试接口为付费接口。

    流控信息

    当前云产品API请求速率暂未透出。

    授权信息

    如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

    具体说明如下:展开详情

    操作访问级别资源类型条件关键字关联操作
    viapi-imageenhan:ErasePerson
    全部资源
    *

    请求参数

    字段名称字段详情
    ImageURLstring

    图像 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理(使用 viapiutils 显式的方案生成 URL)

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ErasePerson/ErasePerson1.jpg参考取值来源:
      ColorizeImage
      RemoveImageSubtitles
    UserMaskstring

    图像对于 Mask 的 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理(使用 viapiutils 显式的方案生成 URL)展开详情

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ErasePerson/ErasePerson6.jpg

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:2FEDA495-9A5D-48B5-8922-98A4FE01D381
    Dataobject

    返回的结果数据内容。

    返回说明

    SDK 参考

    阿里云视觉 AI 图像生产类目下的图像人体擦除能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为图像生产(imageenhan)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    返回示例

    错误码

    全局错误码
    HTTP 状态码错误码错误信息操作
    400
    ParameterError
    The parameter is invalid. Please check again.诊断
    403
    AuthFailed
    An error occurred while performing authorization. Please check your RAM configuration.诊断
    403
    NeedOpen
    Please activate the service first.诊断
    408
    Timeout
    The request has timed out.诊断
    500
    InternalServerError
    A server error occurred while processing your request.诊断
    503
    ServiceUnavailable
    The service is unavailable.诊断

    变更历史

    暂无变更历史

    相关示例