Release Notes and Announcements

Release Notes

Announcements

Product Introduction

Overview

Features

Use Cases

Strengths

Concepts

Regions and Access Endpoints

Specifications and Limits

Service Regions and Service Providers

Billing

Billing Overview

Billing Method

Billable Items

Free Tier

Billing Examples

Viewing and Downloading Bill

Payment Overdue

FAQs

Getting Started

Console

Getting Started with COSBrowser

User Guide

Creating Request

Bucket

Object

Data Management

Batch Operation

Global Acceleration

Monitoring and Alarms

Operations Center

Data Processing

Content Moderation

Smart Toolbox

Data Processing Workflow

Application Integration

User Tools

Tool Overview

Installation and Configuration of Environment

COSBrowser

COSCLI (Beta)

COSCMD

COS Migration

FTP Server

Hadoop

COSDistCp

HDFS TO COS

GooseFS-Lite

Online Tools

Diagnostic Tool

Use Cases

Overview

Access Control and Permission Management

Performance Optimization

Accessing COS with AWS S3 SDK

Data Disaster Recovery and Backup

Domain Name Management Practice

Image Processing

Audio/Video Practices

Workflow

Direct Data Upload

Content Moderation

Data Security

Data Verification

Big Data Practice

COS Cost Optimization Solutions

Using COS in the Third-party Applications

Migration Guide

Migrating Local Data to COS

Migrating Data from Third-Party Cloud Storage Service to COS

Migrating Data from URL to COS

Migrating Data Within COS

Migrating Data Between HDFS and COS

Data Lake Storage

Cloud Native Datalake Storage

Metadata Accelerator

GooseFS

Data Processing

Data Processing Overview

Image Processing

Media Processing

Content Moderation

File Processing Service

File Preview

Troubleshooting

Obtaining RequestId

Slow Upload over Public Network

403 Error for COS Access

Resource Access Error

POST Object Common Exceptions

API Documentation

Introduction

Common Request Headers

Common Response Headers

Error Codes

Request Signature

Action List

Service APIs

Bucket APIs

Object APIs

Batch Operation APIs

Data Processing APIs

Job and Workflow

Content Moderation APIs

Cloud Antivirus API

SDK Documentation

SDK Overview

Preparations

Android SDK

C SDK

C++ SDK

.NET(C#) SDK

Flutter SDK

Go SDK

iOS SDK

Java SDK

JavaScript SDK

Node.js SDK

PHP SDK

Python SDK

React Native SDK

Mini Program SDK

Error Codes

Harmony SDK

Endpoint SDK Quality Optimization

Security and Compliance

Data Disaster Recovery

Data Security

Cloud Access Management

FAQs

Image Tag

PDF

Focus Mode

Font Size

Last updated: 2026-01-09 21:55:57

Feature Description
The image tagging feature uses the persistent processing API of Cloud Infinite to implement image tagging recognition for existing COS data, returning high-confidence topic tags in the images.
Note:
This API is a GET request and uses a synchronous request method. It requires carrying a signature. For specific signature settings, please see Request Signature.
Authorization Description
When using with a sub-account, you need to add ci:CreateDetectLabelJob in the action of the authorization policy. For details on CI access permission, please refer to Cloud Infinite action.
Service Activation
Using this feature requires enabling Cloud Infinite in advance and binding a bucket.
Using this feature requires enabling the AI Content Recognition Service in advance through the console or API.
Use Limits
When using this API, please confirm the relevant restrictions first. For details, see Usage Limits.
Fee Description
This API is a paid service. Generated costs will be charged by Cloud Infinite. For detailed billing instructions, see Content Recognition.
﻿
Request
Original images are stored in COS.
GET /<ObjectKey>?ci-process=detect-label&scenes=<scenes> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Original images come from other links.
GET /?ci-process=detect-label&scenes=<scenes>&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Note:
Authorization: Auth String. For details, see Request Signature document.
Request Content
Parameter Name
Description
Type
Required or Not
ObjectKey
object filename, such as picture.jpg
string
No
ci-process
fixed value detect-label
string
Yes
scenes
Supported recognition scenarios for this call, with the following options:
web Image optimization for networks
camera image optimization for mobile camera shooting
{mobile phone album} {cloud storage product} {product optimization}
Optimized for news, information, broadcasting and television industries
if this parameter is not provided, default to camera
Support multi-scene (scenes) detection together, separated by ,. For example, use scenes = web, camera to apply two models to detect one image simultaneously, outputting two sets of recognition results.
String
No
detect-url
You can process any publicly accessible image link by filling in detect-url. If detect-url is not filled in, 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 ObjectKey. detect-url example: http://www.example.com/abc.jpg, which needs to be url-encoded and processed into http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg.
String
No
Response
The specific data content of the response body is as follows:
Parameter Name
Description
Type
RecognitionResult
Image tag recognition results
Container
Content of the RecognitionResult node
Parameter Name
Description
Type
AlbumLabels
Album edition tag result array
If the album scenario is not selected, this item does not exist. This field may be empty, indicating that no valid value can be obtained.
Container
CameraLabels
Camera edition tag result array
If the camera scenario is not selected, this item does not exist. This field may be empty, indicating that no valid value can be obtained.
Container
NewsLabels
News edition tag result array.
If the news scenario is not selected, this item does not exist. This field may be empty, indicating that no valid value can be obtained.
Container
WebLabels
Web edition tag result array
If the web scenario is not selected, this item does not exist. This field may be empty, indicating that no valid value can be obtained.
Container
WebLabels, CameraLabels, AlbumLabels, NewsLabels
Parameter Name
Description
Type
Labels
Tag information
Container
Content of the Labels node
Parameter Name
Description
Type
Confidence
The confidence score of this tag. The higher the score, the higher the accuracy of the tag.
Int
FirstCategory
Primary category of the tag
String
Name
Recognized image tags
String
SecondCategory
Secondary category of a tag
String
Example
Request
GET /picture.jpg?ci-process=detect-label&scenes=web,camera,album,news HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2019 09:06:15 GMT
Authorization: <Auth String>
Response
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
﻿
<RecognitionResult>
    <AlbumLabels>
        <Labels>
            <Confidence>72</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Deer</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
    </AlbumLabels>
    <CameraLabels>
        <Labels>
            <Confidence>26</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Antelope</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>21</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Rabbit</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>18</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Deer</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>10</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Lion</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>5</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Leopard</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
    </CameraLabels>
    <NewsLabels>
        <Labels>
            <Confidence>60</Confidence>
            <FirstCategory>Plants and other organisms</FirstCategory>
            <Name>Plant</Name>
            <SecondCategory>Plant category</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>38</Confidence>
            <FirstCategory>Plant</FirstCategory>
            <Name>Tree</Name>
            <SecondCategory>Tree</SecondCategory>
        </Labels>
    </NewsLabels>
    <WebLabels>
        <Labels>
            <Confidence>97</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Wildlife</Name>
            <SecondCategory>Other</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>82</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Mammals</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>78</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Animal</Name>
            <SecondCategory>Other</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>71</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>Deer</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
        <Labels>
            <Confidence>41</Confidence>
            <FirstCategory>Animals and plants</FirstCategory>
            <Name>White-tailed Deer</Name>
            <SecondCategory>Mammals</SecondCategory>
        </Labels>
    </WebLabels>
</RecognitionResult>
﻿

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Cloud Object Storage

Image Tag

Feature Description

Authorization Description

Service Activation

Use Limits

Fee Description

Request

Request Content

Response

Example

Request

Response

Help and Support

Parameter Name	Description	Type	Required or Not
ObjectKey	object filename, such as picture.jpg	string	No
ci-process	fixed value detect-label	string	Yes
scenes	Supported recognition scenarios for this call, with the following options: web Image optimization for networks camera image optimization for mobile camera shooting {mobile phone album} {cloud storage product} {product optimization} Optimized for news, information, broadcasting and television industries if this parameter is not provided, default to camera Support multi-scene (scenes) detection together, separated by `,`. For example, use scenes = web, camera to apply two models to detect one image simultaneously, outputting two sets of recognition results.	String	No
detect-url	You can process any publicly accessible image link by filling in detect-url. If detect-url is not filled in, 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 ObjectKey. detect-url example: `http://www.example.com/abc.jpg`, which needs to be url-encoded and processed into `http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg`.	String	No