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:GetObject, ci:CreateSuperResolutionJob.cos:PutObject.cos:GetObject, cos:PutObject (Note: GetObject corresponds to the resource of the source file, and PutObject corresponds to the resource of the transferred file).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>
Parameter | Meaning | Type | Required or Not |
ObjectKey | object filename, for example: folder/document.jpg | String | No |
ci-process | CI processing capability, Image Super Resolution fixed as AISuperResolution | String | Yes |
detect-url | You can handle any publicly accessible image link by filling in detect-url. If detect-url is not filled in, the backend will process ObjectKey by default. If detect-url is filled in, the backend will process the detect-url link, and there is no need to fill in ObjectKey.detect-url example: http://www.example.com/abc.jpg, needs to be UrlEncoded, processed as http%3A%2F%2Fwww.example.com%2Fabc.jpg. | String | No |
magnify | Target magnification times, optional parameters 2, 4, default is 2 | int | No |
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]
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: <PicOperations>
Header Name | Description | Type |
Pic-Operations | Parameters for image operations | String |
Parameter Name | Description | Type | Required or Not |
is_pic_info | Whether to return original image information, 0 means do not return original image information, 1 means return original image information, default is 0 | Int | No |
rules | Processing rules, one rule corresponds to one processing result (currently supports five rules), leave blank to skip image processing | Array | No |
Parameter Name | Description | Type | Required or Not |
bucket | Destination bucket name for storing results, format is BucketName-AppId, if not specified, it will default save to the current bucket. | String | No |
fileid | Storage path and name of the processed file. Rule description for naming. For example, the file path and filename of the source object are: /p1/test1.jpgAn absolute path starts with /, for example, when the fileid value is /p2/test2.jpg, it means a file named test2.jpg is stored in the p2 folder. A relative path does not start with /. For example, when the fileid value is p2/test2.jpg, it means a p2 folder is created in the p1 folder, and then a file named test2.jpg is stored in the p2 folder. Note: Do not end with /, otherwise an empty filename will occur. If you want the repaired image to overwrite the original image, set the fileid field to <ObjectKey> | String | Yes |
rule | Processing parameters, such as: ci-process = AISuperResolution or ci-process = AISuperResolution&magnify = 2 | String | Yes |
Node Name (Keyword) | Parent Node | Description | Type |
UploadResult | None. | Request result. | Container |
Node Name (Keyword) | Parent Node | Description | Type |
OriginalInfo | UploadResult | Image information | Container |
ProcessResults | UploadResult | Request processing result | Container |
Node Name | Parent Node | Description | Type |
Key | OriginalInfo | Original image filename | String |
Location | OriginalInfo | Original image path | String |
ETag | OriginalInfo | Original image ETag value | String |
Node Name (Keyword) | Parent Node | Description | Type |
Object | ProcessResults | Processing result of each image | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Key | Object | Image file name after super-resolution | String |
Location | Object | Image link after super-resolution | String |
ETag | Object | ETag value of the super-resolved image | String |
Size | Object | Image size after super-resolution | 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&magnify=2"}]}
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>
POST /<ObjectKey>?image_process HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: <PicOperations>
Header Name | Description | Type |
Pic-Operations | Parameters for image operations | String |
Parameter Name | Description | Type | Required or Not |
is_pic_info | Whether to return original image information, 0 means do not return original image information, 1 means return original image information, default is 0 | Int | No |
rules | Processing rules, one rule corresponds to one processing result (currently supports five rules), leave blank to skip image processing | Array | No |
Parameter Name | Description | Type | Required or Not |
bucket | Destination bucket name for storing results, format is BucketName-AppId, if not specified, it will default save to the current bucket. | String | No |
fileid | Storage path and name of the processed file. Rule description for naming. For example, the source file path and filename are: /p1/test1.jpg An absolute path starts with /. For example, when the fileid value is /p2/test2.jpg, it means a file named test2.jpg is stored in the p2 folder. A relative path does not start with /. For example, when the fileid value is p2/test2.jpg, it means a p2 folder is created in the p1 folder, and then a file named test2.jpg is stored in the p2 folder. Note: Do not end with /, otherwise an empty filename will occur. If you want the repaired image to overwrite the original image, set the fileid field to <ObjectKey> | String | Yes |
rule | Processing parameters, such as: ci-process = AISuperResolution or ci-process = AISuperResolution&magnify = 2 | String | Yes |
Node Name (Keyword) | Parent Node | Description | Type |
UploadResult | None. | Request result. | Container |
Node Name (Keyword) | Parent Node | Description | Type |
OriginalInfo | UploadResult | Image information | Container |
ProcessResults | UploadResult | Request processing result | Container |
Node Name | Parent Node | Description | Type |
Key | OriginalInfo | Original image filename | String |
Location | OriginalInfo | Original image path | String |
ETag | OriginalInfo | Original image ETag value | String |
Node Name (Keyword) | Parent Node | Description | Type |
Object | ProcessResults | Processing result of each image | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Key | Object | Image file name after super-resolution | String |
Location | Object | Image link after super-resolution | String |
ETag | Object | ETag value of the super-resolved image | String |
Size | Object | image size | 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&magnify=2"}]}
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>
피드백