对象存储图片上色-API 文档-文档中心-腾讯云

功能描述
腾讯云数据万象通过 AIImageColoring 接口对黑白图像进行上色。
注意
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
授权说明
下载时处理：授权策略中 action 设置为 cos:GetObject、ci:CreateAIImageColoringJob。
上传时处理：授权策略中 action 设置为 cos:PutObject、ci:CreateAIImageColoringJob。
云上数据处理：授权策略中 action 设置为 cos:GetObject、cos:PutObject、ci:CreateAIImageColoringJob（注意 GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件）。
查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
1. 下载时处理
请求：
原图存储在 COS：  
GET /<ObjectKey>?ci-process=AIImageColoring HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
处理参数说明
操作名称：AIImageCrop。
参数
含义
类型
是否必选
ObjectKey
对象文件名，例如：folder/document.jpg。
String
是
ci-process
数据万象处理能力，只能裁剪参固定为 AIImageColoring。
String
是
响应：
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]
处理后的图片直接返回至响应体。
2.上传时处理
请求
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=AIImageColoring"
  }]
}
处理后的图片存至存储桶，并以 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>
3.云上数据处理
请求
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=AIImageColoring"
  }]
}
处理后的图片存至存储桶，并以 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>
﻿
参数	含义	类型	是否必选
ObjectKey	对象文件名，例如：folder/document.jpg。	String	是
ci-process	数据万象处理能力，只能裁剪参固定为 AIImageColoring。	String	是
图片上色

本页目录：

功能描述

授权说明

服务开通

使用限制

1. 下载时处理

请求：

处理参数说明

响应：

2.上传时处理

请求

响应：

3.云上数据处理

请求
