功能描述
腾讯云数据万象通过 AISuperResolution 接口对图像进行超分辨率处理，当前默认超分为宽高的2倍，最大放大至原分辨率的4倍。注意：本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
授权说明
下载时处理：授权策略中 action 设置为 cos:GetObject、ci:CreateAISuperResolutionJob。上传时处理：授权策略中 action 设置为 cos:PutObject、ci:CreateAISuperResolutionJob。云上数据处理：授权策略中 action 设置为 cos:GetObject、cos:PutObject、ci:CreateAISuperResolutionJob（注意 GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件）。 查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
1. 下载时处理
请求：
原图存储在COS：
GET /<ObjectKey>?ci-process=AISuperResolution HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
原图来自其他链接：
GET /?ci-process=AISuperResolution&detect-url=<detect-url> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
处理参数说明
操作名称：AISuperResolution。
| 参数 | 含义 | 类型 | 是否必选 |
| ObjectKey | 对象文件名，例如：folder/document.jpg。 | String | 否 |
| ci-process | 数据万象处理能力，图像超分固定为 AISuperResolution。 | String | 是 |
| 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 | 否 |
| magnify | 目标放大倍数，默认为2，范围[2,4]，仅支持偶数 | Int | 否 |
响应：
HTTP/1.1 200 OKContent-Type: image/pngContent-Length: 98645Date: Tue, 23 Apr 2022 09:06:16 GMTStatus: 200 OKx-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
[pic-content]
处理后的图片直接返回至响应体。
2.上传时处理
请求语法
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: <PicOperations>
说明：Authorization:Auth String （详情请参见 请求签名 文档）。
请求内容
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
除公共头部外，还需要传入如下头部。
| 头部名称 | 描述 | 类型 |
| Pic-Operations | 对图片进行操作的参数 | String |
Pic-Operations 为 json 格式的字符串，具体参数如下：
| 参数名称 | 类型 | 是否必选 | 描述 |
| is_pic_info | Int | 否 | 是否返回原图信息，0不返回原图信息，1返回原图信息，默认为0 |
| rules | Array | 否 | 处理规则，一条规则对应一个处理结果（目前支持五条规则），不填则不进行图片处理 |
rules（json 数组）中每一项具体参数如下：
| 参数名称 | 类型 | 是否必选 | 描述 |
| bucket | String | 否 | 存储结果的目标存储桶名称，格式为 BucketName-AppId，如果不指定的话默认保存到当前存储桶 |
| fileid | String | 是 | 处理后文件的保存路径及名称。名称规则说明：例如源文件的路径及文件名为：/p1/test1.jpg1. 以/开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件2. 不以/开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 p1 文件夹中新建了一个 p2 文件夹，然后在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件3. 注意：请不要以/结尾，否则会产生空文件名4. 如希望修复后的图片覆盖原图，请将 fileid 字段设置为 ObjectKey |
| rule | String | 是 | 处理参数，固定为：ci-process=AISuperResolution |
请求体
该请求body内容为待上色图片原图
[Image Content]
响应
响应头
此接口返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回content-type为 application/xml 数据，具体的数据内容如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| UploadResult | 无 | 请求结果 | Container |
UploadResult 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| OriginalInfo | UploadResult | 原图信息 | Container |
| ProcessResults | UploadResult | 请求处理结果 | Container |
OriginalInfo 节点内容：
| 节点名称 | 父节点 | 描述 | 类型 |
| Key | OriginalInfo | 原图文件名 | String |
| Location | OriginalInfo | 原图路径 | String |
| ETag | OriginalInfo | 原图 ETag 值 | String |
ProcessResults 节点内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Object | ProcessResults | 每个图片的处理结果 | Container |
Object 节点内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Key | Object | 超分后图片文件名 | String |
| Location | Object | 超分后的图片链接 | String |
| ETag | Object | 超分后图片的 ETag 值 | String |
| Size | Object | 超分后图片大小 | Int |
示例：
请求
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: { "is_pic_info": 1, "rules": [{ "fileid": "exampleobject", "rule": "ci-process=AISuperResolution" }]}
响应：
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 645Date: Tue, 23 Apr 2022 09:06:16 GMTStatus: 200 OKServer: tencent-cix-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>
3.云上数据处理
请求语法
POST /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: <PicOperations>
说明：Authorization:Auth String （详情请参见 请求签名 文档）。
请求内容
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
除公共头部外，还需要传入如下头部。
| 头部名称 | 描述 | 类型 |
| Pic-Operations | 对图片进行操作的参数 | String |
Pic-Operations 为 json 格式的字符串，具体参数如下：
| 参数名称 | 类型 | 是否必选 | 描述 |
| is_pic_info | Int | 否 | 是否返回原图信息，0不返回原图信息，1返回原图信息，默认为0 |
| rules | Array | 否 | 处理规则，一条规则对应一个处理结果（目前支持五条规则），不填则不进行图片处理 |
rules（json 数组）中每一项具体参数如下：
| 参数名称 | 类型 | 是否必选 | 描述 |
| bucket | String | 否 | 存储结果的目标存储桶名称，格式为 BucketName-AppId，如果不指定的话默认保存到当前存储桶 |
| fileid | String | 是 | 处理后文件的保存路径及名称。名称规则说明：例如源文件的路径及文件名为：/p1/test1.jpg1. 以/开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件2. 不以/开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 p1 文件夹中新建了一个 p2 文件夹，然后在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件3. 注意：请不要以/结尾，否则会产生空文件名4. 如希望修复后的图片覆盖原图，请将 fileid 字段设置为 ObjectKey |
| rule | String | 是 | 处理参数，固定为：ci-process=AISuperResolution |
请求体
该请求body内容为待上色图片原图
[Image Content]
响应
响应头
此接口返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回content-type为 application/xml 数据，具体的数据内容如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| UploadResult | 无 | 请求结果 | Container |
UploadResult 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| OriginalInfo | UploadResult | 原图信息 | Container |
| ProcessResults | UploadResult | 请求处理结果 | Container |
OriginalInfo 节点内容：
| 节点名称 | 父节点 | 描述 | 类型 |
| Key | OriginalInfo | 原图文件名 | String |
| Location | OriginalInfo | 原图路径 | String |
| ETag | OriginalInfo | 原图 ETag 值 | String |
ProcessResults 节点内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Object | ProcessResults | 每个图片的处理结果 | Container |
Object 节点内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Key | Object | 超分后图片文件名 | String |
| Location | Object | 超分后的图片链接 | String |
| ETag | Object | 超分后图片的 ETag 值 | String |
| Size | Object | 图片大小 | Int |
示例
请求
POST /<ObjectKey>?image_process HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateContent-length: SizeAuthorization: Auth StringPic-Operations: { "rules": [{ "fileid": "exampleobject", "rule": "ci-process=AISuperResolution" }]}
处理后的图片存至存储桶，并以fileid字段的值作为对象名称。
响应：
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 645Date: Tue, 23 Apr 2022 09:06:16 GMTStatus: 200 OKServer: tencent-cix-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>
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145200.html
