数据万象
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数据万象 > API 文档 > AI 内容识别 > 图像增强

图像增强

最近更新时间：2024-01-08 16:18:45

我的收藏

本页目录：

功能描述

腾讯云数据万象通过 AIEnhanceImage 接口对图像进行增强处理。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。

授权说明

通过子账号使用时，需要授予对应权限，COS权限具体请参见 COS action，CI 权限具体请参见 数据万象 action。
下载时处理：授权策略中 action 设置为 cos:GetObject、ci:CreateAIEnhanceImageJob。
上传时处理：授权策略中 action 设置为 cos:PutObject、ci:CreateAIEnhanceImageJob。
云上数据处理：授权策略中 action 设置为 cos:GetObject、cos:PutObject、ci:CreateAIEnhanceImageJob（注意 GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件）。

服务开通

使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

费用说明

该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 内容识别费用。


处理方式一：下载时处理

请求

请求语法

原图存储在COS： 
GET /<ObjectKey>?ci-process=AIEnhanceImage&denoise=<denoise>&sharpen=<sharpen> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接：
GET /<ObjectKey>?ci-process=AIEnhanceImage&denoise=<denoise>&sharpen=<sharpen> HTTP/1.1
Host: <BucketName-APPID>.pic.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

请求内容

操作名称：AIEnhanceImage。
参数
含义
类型
是否必选
ObjectKey
对象文件名，例如：folder/document.jpg。
String
是
ci-process
数据万象处理能力，图像增强固定为 AIEnhanceImage。
String
是
denoise
去噪强度值，取值范围为 0 - 5 之间的整数，值为 0 时不进行去噪操作，默认值为3。
Integer
否
sharpen
锐化强度值，取值范围为 0 - 5 之间的整数，值为 0 时不进行锐化操作，默认值为3。
Integer
否
detect-url
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了detect-url 时，后台会处理 detect-url链接，无需再填写 ObjectKey ，detect-url 示例：http://www.example.com/abc.jpg ，需要进行 UrlEncode，处理后为 http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
String
否
ignore-error
当此参数为1时，针对文件过大等导致处理失败的场景，会直接返回原图而不报错。
Integer
否

响应

HTTP/1.1 200 OK
Content-Type: image/png
Content-Length: 98645
Date: Tue, 23 Apr 2022 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

[pic-content]
处理后的图片直接返回至响应体。

处理方式二：上传时处理

请求

请求语法

PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: 
{
  "is_pic_info": 1,
  "rules": [{
      "fileid": "exampleobject",
      "rule": "ci-process=AIEnhanceImage"
  }]
}
处理后的图片存至存储桶，并以 fileid 字段的值作为对象名称。

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 23 Apr 2022 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<UploadResult>
    <OriginalInfo>
        <Key>ObjectKey</Key>
        <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location>
        <ETag>"ed60e3598e6862d8c8443a06acfb2153"</ETag>
    </OriginalInfo>
    <ProcessResults>
        <Object>
            <Key>exampleobject</Key>
            <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
            <Format/>
            <Size>354256</Size>
            <ETag>"521451f63c331becf533e466732c1091"</ETag>
        </Object>
    </ProcessResults>
</UploadResult>

处理方式三：云上数据处理

请求

POST /<ObjectKey>?image_process HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations: 
{
  "rules": [{
      "fileid": "exampleobject",
      "rule": "ci-process=AIEnhanceImage"
  }]
}
处理后的图片存至存储桶，并以 fileid 字段的值作为对象名称。

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 23 Apr 2022 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<UploadResult>
    <OriginalInfo>
        <Key>ObjectKey</Key>
        <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location>
        <ETag>"ed60e3598e6862d8c8443a06acfb2153"</ETag>
    </OriginalInfo>
    <ProcessResults>
        <Object>
            <Key>exampleobject</Key>
            <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
            <Format/>
            <Size>354256</Size>
            <ETag>"521451f63c331becf533e466732c1091"</ETag>
        </Object>
    </ProcessResults>
</UploadResult>

中国站