对象存储通用抠图-SDK 文档-文档中心-腾讯云

简介
本文档提供关于通用抠图的相关 API 概览以及 SDK 示例代码。
API
操作描述
﻿通用抠图﻿
通用抠图
通用抠图
功能说明
数据万象通用抠图 AIPicMatting 接口检测图片中的主体信息，自动分割图片背景，生成只包含主体信息的图片，支持持久化、云上处理及下载时处理。
示例代码
def cos_ai_pic_matting():
    # 通用抠图
    response, data = client.cos_ai_pic_matting(
        Bucket=bucket_name,
        ObjectKey="heibai.jpeg",
        # DetectUrl="https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg"
        CenterLayout=1,
        PaddingLayout="10x10",
        Stream=True
    )
    data.get_stream_to_file('result.jpg')
    print(response)
    return response, data
参数说明
调用 cos_ai_pic_matting 函数，具体请求参数如下：
参数名称
参数描述
类型
是否必填
Bucket
存储桶名称
String
是
ObjectKey
设置对象名称，ObjectKey 与 DetectUrl 中必传一个
String
是
DetectUrl
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了 detect-url 时，后台会处理 detect-url 链接，无需再填写 ObjectKey。detect-url 示例：http://www.example.com/abc.jpg，ObjectKey 与 DetectUrl中必传一个
String
否
CenterLayout
抠图主体居中显示；值为1时居中显示，值为0不做处理，默认为0
Integer
否
PaddingLayout
将处理后的图片四边进行留白，形式为 padding-layout=<dx>x<dy>，左右两边各进行 dx 像素的留白，上下两边各进行 dy 像素的留白，例如：padding-layout=20x10，默认不进行留白操作，dx、dy 最大值为1000像素。
String
否
Stream
是否以流式方式接收响应内容，默认为 True
Boolean
否
返回结果说明
response 为响应头， 数据类型为 dict。 data 为通用抠图结果。
response内容
返回公共响应头部，详情请参见 公共响应头部 文档。
响应体data
[pic-content]
﻿

参数名称	参数描述	类型	是否必填
Bucket	存储桶名称	String	是
ObjectKey	设置对象名称，ObjectKey 与 DetectUrl 中必传一个	String	是
DetectUrl	您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了 detect-url 时，后台会处理 detect-url 链接，无需再填写 ObjectKey。detect-url 示例：`http://www.example.com/abc.jpg`，ObjectKey 与 DetectUrl中必传一个	String	否
CenterLayout	抠图主体居中显示；值为1时居中显示，值为0不做处理，默认为0	Integer	否
PaddingLayout	将处理后的图片四边进行留白，形式为 padding-layout=<dx>x<dy>，左右两边各进行 dx 像素的留白，上下两边各进行 dy 像素的留白，例如：padding-layout=20x10，默认不进行留白操作，dx、dy 最大值为1000像素。	String	否
Stream	是否以流式方式接收响应内容，默认为 True	Boolean	否

通用抠图

本页目录：

简介

通用抠图

功能说明

示例代码

参数说明

返回结果说明

response内容

响应体data