History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
方式 | 类别 | 说明 |
下载时处理 | 同步处理 | |
上传时处理 | 同步处理 | |
云上数据处理 | 同步处理 | |
异步处理任务 | 异步处理 | 针对 COS 上已经存在的图片，通过创建图片处理异步任务进行处理，处理后的图片将会存储在对象存储 COS 中。 |
GET /<ObjectKey>?<图片处理参数> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
GET /filename.jpg?imageMogr2/format/png HTTP/1.1Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.comDate: Wed, 28 Oct 2015 20:32:00 GMTAuthorization: <Auth String>
HTTP/1.1 200 OKContent-Type: image/pngContent-Length: 565Date: Fri, 10 Apr 2020 09:35:16 GMTLast-Modified: Fri, 10 Apr 2020 09:35:05 GMTx-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Pic-Operations: <PicOperations>
参数名称 | 类型 | 是否必选 | 描述 |
is_pic_info | Int | 否 | 是否返回原图信息，0不返回原图信息，1返回原图信息，默认为0。 |
rules | Array | 否 | 处理规则，一条规则对应一个处理结果（目前支持五条规则），不填则不进行图片处理。 |
参数名称 | 类型 | 是否必选 | 描述 |
bucket | String | 是 | 存储结果的目标存储桶名称，格式为 BucketName-APPID。 |
fileid | String | 是 | 处理后文件的保存路径及名称。 当 fileid 与 ObjectKey 相同时，处理后的文件将覆盖原文件存储；不相同时将分别存储原文件和处理后文件。名称规则说明：名称需要经过 URLEncode。 以 / 开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件。不以 / 开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 ObjectKey 所在的文件夹中新建了一个 p2文件夹，然后在 p2文件夹中存储了一个文件名为 test2.jpg 的文件。注意：请不要以 / 结尾，否则会产生空文件名。 |
rule | String | 是 |
参数名称 | 类型 | 描述 |
UploadResult | Container | 原图信息 |
参数名称 | 类型 | 描述 |
OriginalInfo | Container | 原图信息 |
ProcessResults | Container | 图片处理结果 |
节点名称 | 类型 | 描述 |
Key | String | 原图文件名 |
Location | String | 图片路径 |
ImageInfo | Container | 原图图片信息 |
ETag | String | 原图 ETag 信息（若处理结果图覆盖原图则为结果图 ETag 信息） |
节点名称 | 类型 | 描述 |
Md5 | String | 校验值，Md5用于文件完整性校验、避免重复上传和标识文件的唯一性 |
Format | String | 图片格式 |
Width | Int | 图片宽度 |
Height | Int | 图片高度 |
Quality | Int | 图片质量 |
Ave | String | 图片主色调，格式为：0xRRGGBB （RR、GG、BB都是十六进制数，表示红、绿、蓝三种颜色） |
FrameCount | Int | 图片的帧数。静态图为1，动图为对应的帧数. |
BitDepth | Int | 图像每个颜色通道所使用的比特数，反映图像的色彩精度 |
VerticalDpi | Int | 图像垂直方向的分辨率 |
HorizontalDpi | Int | 图像水平方向的分辨率 |
节点名称 | 类型 | 描述 |
Object | Container | 每一个图片处理结果 |
节点名称 | 类型 | 描述 |
Key | String | 文件名 |
Location | String | 图片路径 |
Format | String | 图片格式 |
Md5 | String | 校验值，Md5用于文件完整性校验、避免重复上传和标识文件的唯一性 |
Width | Int | 图片宽度 |
Height | Int | 图片高度 |
Size | Int | 图片大小 |
Quality | Int | 图片质量 |
Ave | String | 图片主色调，格式为：0xRRGGBB （RR、GG、BB都是十六进制数，表示红、绿、蓝三种颜色） |
FrameCount | Int | 图片的帧数。静态图为1，动图为对应的帧数。 |
BitDepth | String | 图像每个颜色通道所使用的比特数，反映图像的色彩精度。 |
VerticalDpi | Int | 图像垂直方向的分辨率。 |
HorizontalDpi | Int | 图像水平方向的分辨率。 |
ETag | Int | 处理结果图 ETag 信息。 |
PUT /filename.jpg HTTP/1.1Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.comDate: Wed, 28 Oct 2015 20:32:00 GMTAuthorization:q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************Pic-Operations: {"is_pic_info":1,"rules":[{"bucket":"examplebucket-1250000000","fileid":"test.png","rule":"imageMogr2/format/png"}]}Content-Length: 64[Object]
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 645Date: Tue, 03 Apr 2018 09:06:16 GMTStatus: 200 OKx-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****<UploadResult><OriginalInfo><Key>filename.jpg</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location><ETag>"580cd6930444576523c25f86ce2af9b1fc2d5484"</ETag><ImageInfo><Format>JPEG</Format><Width>640</Width><Height>427</Height><Quality>100</Quality><Ave>0xa18454</Ave><Orientation>1</Orientation><FrameCount>1</FrameCount></ImageInfo></OriginalInfo><ProcessResults><Object><Key>test.png</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/test.png</Location><Format>png</Format><Width>640</Width><Height>427</Height><Size>463092</Size><Quality>100</Quality><ETag>"eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c"</ETag><FrameCount>1</FrameCount></Object></ProcessResults></UploadResult>
POST /<ObjectKey>?uploadId=UploadId HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Content-length: <Size>Authorization: <Auth String>Pic-Operations: <PicOperations>
POST /<ObjectKey>?image_process HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Content-length: <Size>Authorization: <Auth String>Pic-Operations: <PicOperations>
参数名称 | 类型 | 是否必选 | 描述 |
is_pic_info | Int | 否 | 是否返回原图信息，0不返回原图信息，1返回原图信息，默认为0。 |
rules | Array | 否 | 处理规则，一条规则对应一个处理结果（目前支持五条规则），不填则不进行图片处理。 |
参数名称 | 类型 | 是否必选 | 描述 |
bucket | String | 否 | 存储结果的目标 bucket 名称，形如 BucketName-APPID，如果不指定的话默认保存到当前存储桶。 |
fileid | String | 是 | 处理后文件的保存路径及名称。 当 fileid 与 ObjectKey 相同时，处理后的文件将覆盖原文件存储；不相同时将分别存储原文件和处理后文件。名称规则说明：名称需要经过 URLEncode。 以 /开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件。不以 /开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在ObjectKey所在的文件夹中新建了一个 p2文件夹，然后在 p2文件夹中存储了一个文件名为 test2.jpg 的文件。注意：请不要以 / 结尾，否则会产生空文件名。 |
rule | String | 是 | 处理参数，参见对象存储图片处理 API。若按指定样式处理，则以 style/ 开头，后加样式名，如样式名为 test，则 rule 字段为 style/test。 |
参数名称 | 类型 | 描述 |
UploadResult | Container | 原图信息 |
参数名称 | 类型 | 描述 |
OriginalInfo | Container | 原图信息 |
ProcessResults | Container | 图片处理结果 |
节点名称 | 类型 | 描述 |
Key | String | 原图文件名 |
Location | String | 图片路径 |
ImageInfo | Container | 原图图片信息 |
ETag | String | 原图 ETag 信息（若处理结果图覆盖原图则为结果图 ETag 信息） |
节点名称 | 类型 | 描述 |
Md5 | String | 校验值，Md5用于文件完整性校验、避免重复上传和标识文件的唯一性 |
Format | String | 格式 |
Width | Int | 图片宽度 |
Height | Int | 图片高度 |
Quality | Int | 图片质量 |
Ave | String | 图片主色调，格式为：0xRRGGBB （RR、GG、BB都是十六进制数，表示红、绿、蓝三种颜色） |
FrameCount | Int | 图片的帧数。静态图为1，动图为对应的帧数. |
BitDepth | Int | 图像每个颜色通道所使用的比特数，反映图像的色彩精度 |
VerticalDpi | Int | 图像垂直方向的分辨率 |
HorizontalDpi | Int | 图像水平方向的分辨率 |
节点名称 | 类型 | 描述 |
Object | Container | 每一个图片处理结果 |
节点名称 | 类型 | 描述 |
Key | String | 文件名 |
Location | String | 图片路径 |
Format | String | 图片格式 |
Md5 | String | 校验值，Md5用于文件完整性校验、避免重复上传和标识文件的唯一性 |
Width | Int | 图片宽度 |
Height | Int | 图片高度 |
Size | Int | 图片大小 |
Quality | Int | 图片质量 |
FrameCount | Int | 图片的帧数。静态图为1，动图为对应的帧数。 |
BitDepth | Int | 图像每个颜色通道所使用的比特数，反映图像的色彩精度 |
VerticalDpi | Int | 图像垂直方向的分辨率 |
HorizontalDpi | Int | 图像水平方向的分辨率 |
ETag | String | 处理结果图 ETag 信息 |
POST /filename.jpg?image_process HTTP/1.1Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.comDate: Wed，18 Jan 2017 16:17:03 GMTAuthorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************Pic-Operations: {"is_pic_info":1,"rules":[{"bucket":"examplebucket-1250000000","fileid":"test.png","rule":"imageMogr2/format/png"}]}Content-Length: 64
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 645Date: Tue, 03 Apr 2018 09:06:16 GMTStatus: 200 OKx-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****<UploadResult><OriginalInfo><Key>filename.jpg</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location><ETag>"eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c"</ETag><ImageInfo><Format>JPEG</Format><Width>640</Width><Height>427</Height><Quality>100</Quality><Ave>0xa18454</Ave><Orientation>1</Orientation><FrameCount>1</FrameCount></ImageInfo></OriginalInfo><ProcessResults><Object><Key>test.png</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/test.png</Location><Format>png</Format><Width>640</Width><Height>427</Height><Size>463092</Size><Quality>100</Quality><ETag>"eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c"</ETag><FrameCount>1</FrameCount></Object></ProcessResults></UploadResult>
文档反馈