tencent cloud

Retrieve Original Image
Download PDF
Last updated: 2025-09-08 16:56:47
Retrieve Original Image
Last updated: 2025-09-08 16:56:47
Download PDF

Feature Overview

If you enable Original Image Protection and want to obtain the original image in some scenarios, you can use this interface to obtain it.
Note:
This request operation does not support anonymous requests and must carry a signature.

Authorization Guide

When used with a sub-account, the cos:GetObject permission must be granted. For details, please refer to COS action. For other CI permissions, please refer to Cloud Infinite.

Service Activation

Using this feature requires no service activation or role authorization and can be used directly. After use, it will automatically activate the Cloud Infinite service and bind your bucket.

Use Limits

When using this API, please first confirm the relevant restrictions. For details, see Specifications and Limits.

Fee Description

This API is a paid service. The incurred fees will be collected by CI. For detailed billing instructions, see Image Processing Fees.
If processing during download is adopted and the download is performed via the public network, the API call will incur Traffic Fees.

Request

Request Sample

GET /<ObjectKey>?ci-process=originImage HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

Request Parameters

Parameter
Description
Type
Required
ObjectKey
Object filename, for example folder/sample.png.
String
Yes
ci-process
Cloud Infinite general parameter, when you need to get the original image, this parameter is fixed as: originImage
String
Yes

Request Header.

This API has no special request headers.

Request Body.

This API has no request body.

Response

Response Header

This API has no special response headers.

Response Body

The response body of this API is the content of a file object.

Practical Example

Access an image in a bucket with Original Image Protection enabled, carrying the original image retrieval parameter:
http://example-1250000000.cos.ap-chengdu.myqcloud.com/?ci-process=originImage&q-sign-algorithm=sha1&q-ak=xxx&q-sign-time=1682323014;1682326614&q-key-time=1682323014;1682326614&q-header-list=&q-url-param-list=ci-process&q-signature=xxxxx
Note:
<signature> is the signature part. To obtain it, please refer to Request Signature documentation.

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback