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:CreateS3AIPicPortraitMattingJob in the authorization policy.cos:PutObject in the authorization policy.cos:GetObject, cos:PutObject in the authorization policy. (Note: GetObject corresponds to the source file resource, and PutObject corresponds to the transferred file resource).GET /<ObjectKey>?ci-process=AIPortraitMatting HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
GET /<ObjectKey>?ci-process=AIPortraitMatting&detect-url=<detect-url> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
Parameter | Meaning | Type | Required |
ObjectKey | Object filename, for example: folder/document.jpg | String | No |
ci-process | Cloud Infinite processing capability, portrait matting fixed as AIPortraitMatting | String | Yes |
detect-url | You can process any publicly accessible image link by filling in detect-url. If detect-url is not specified, the backend will process the 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 the ObjectKey. detect-url example: http://www.example.com/abc.jpg, which needs to be url-encoded, and the processed result is http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg | String | No |
center-layout | Center the subject in the image; display centered when the value is 1, no action taken when the value is 0, default is 0 | Integer | No |
padding-layout | Apply padding to all four sides of the processed image, with the format padding-layout = <dx> x <dy>, where dx pixels are added to the left and right sides, and dy pixels are added to the top and bottom sides. For example: padding-layout = 20 x 10 Default does not perform blanking operation, maximum value of dx and dy is 1000 pixels. | String | No |
HTTP/1.1 200 OKContent-Type: image/pngContent-Length: 98645Date: Tue, 23 Apr 2022 09:06:16 GMTServer: tencent-ciStatus: 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 | Description | Type | Required |
is_pic_info | Whether to return original image information, 0 means no, 1 means yes, default is 0 | Int | No |
rules | Processing rule, Content Recognition only supports one rule | Array | No |
Parameter Name | Description | Type | Required |
bucket | Destination bucket name for storing results, format is BucketName-AppId, if not specified, it will be saved to the current bucket by default | String | No |
fileid | Storage path and name of the processed file. Name rule description: For example, the source file path and name are: /p1/test1.jpg Absolute paths start with /, for example, when the fileid value is /p2/test2.jpg, it means a file named test2.jpg is stored in the p2 folder. Relative paths do 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. 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 | Fixed as: ci-process = AIPortraitMatting Other processing parameters refer to processing during download | 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 | 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 matting | String |
Location | Object | Image link after matting | String |
ETag | Object | ETag value of the image after matting | String |
Size | Object | Image size after matting | 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=AIPortraitMatting"}]}
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>goods_matting.jpg</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location><ETag>"ed60e3598e6862d8c8443a06acfb2153"</ETag></OriginalInfo><ProcessResults><Object><Key>goods_matting_process.jpeg</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 | Description | Type | Required |
is_pic_info | Whether to return original image information, 0 means no, 1 means yes, default is 0 | Int | No |
rules | Processing rules, one rule corresponds to one processing result (currently supports five rules). If left blank, no image processing will be performed. | Array | No |
Parameter Name | Description | Type | Required |
bucket | Destination bucket name for storing results, format is BucketName-AppId, if not specified, it will be saved to the current bucket by default | String | No |
fileid | Storage path and name of the processed file. Name rule description: For example, the source file path and name are: /p1/test1.jpg Absolute paths start with /, for example, when the fileid value is /p2/test2.jpg, it means a file named test2.jpg is stored in the p2 folder. Relative paths do 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. 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 | Fixed as: ci-process = AIPortraitMatting. center-layout and padding-layout match processing during download. | 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 matting | String |
Location | Object | Image link after matting | String |
ETag | Object | ETag value of the image after matting | String |
Size | Object | Image size after matting | 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=AIPortraitMatting"}]}
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>goods_matting.jpg</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location><ETag>"ed60e3598e6862d8c8443a06acfb2153"</ETag></OriginalInfo><ProcessResults><Object><Key>goods_matting_process.jpeg</Key><Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location><Format/><Size>354256</Size><ETag>"521451f63c331becf533e466732c1091"</ETag></Object></ProcessResults></UploadResult>
フィードバック