/
ImsClient.cs
211 lines (199 loc) · 15.2 KB
/
ImsClient.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
/*
* Copyright (c) 2018 THL A29 Limited, a Tencent company. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
namespace TencentCloud.Ims.V20201229
{
using Newtonsoft.Json;
using System.Threading.Tasks;
using TencentCloud.Common;
using TencentCloud.Common.Profile;
using TencentCloud.Ims.V20201229.Models;
public class ImsClient : AbstractClient{
private const string endpoint = "ims.tencentcloudapi.com";
private const string version = "2020-12-29";
private const string sdkVersion = "SDK_NET_3.0.996";
/// <summary>
/// Client constructor.
/// </summary>
/// <param name="credential">Credentials.</param>
/// <param name="region">Region name, such as "ap-guangzhou".</param>
public ImsClient(Credential credential, string region)
: this(credential, region, new ClientProfile { Language = Language.ZH_CN })
{
}
/// <summary>
/// Client Constructor.
/// </summary>
/// <param name="credential">Credentials.</param>
/// <param name="region">Region name, such as "ap-guangzhou".</param>
/// <param name="profile">Client profiles.</param>
public ImsClient(Credential credential, string region, ClientProfile profile)
: base(endpoint, version, credential, region, profile)
{
SdkVersion = sdkVersion;
}
/// <summary>
/// 本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
/// ### 接口使用说明：
/// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
/// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
///
/// ### 接口功能说明：
/// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
/// - 支持对GIF图/长图进行截帧或拆分检测；
/// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
/// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
/// - 支持根据不同的业务场景配置自定义的审核策略；
/// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
/// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
/// ### 接口调用说明：
/// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<40000分辨率**,并且**图片长宽比<90:1；**
/// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
/// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
/// - 图片文件链接支持的传输协议：HTTP、HTTPS；
/// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
/// - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
/// </summary>
/// <param name="req"><see cref="CreateImageModerationAsyncTaskRequest"/></param>
/// <returns><see cref="CreateImageModerationAsyncTaskResponse"/></returns>
public Task<CreateImageModerationAsyncTaskResponse> CreateImageModerationAsyncTask(CreateImageModerationAsyncTaskRequest req)
{
return InternalRequestAsync<CreateImageModerationAsyncTaskResponse>(req, "CreateImageModerationAsyncTask");
}
/// <summary>
/// 本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
/// ### 接口使用说明：
/// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
/// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
///
/// ### 接口功能说明：
/// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
/// - 支持对GIF图/长图进行截帧或拆分检测；
/// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
/// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
/// - 支持根据不同的业务场景配置自定义的审核策略；
/// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
/// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
/// ### 接口调用说明：
/// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<40000分辨率**,并且**图片长宽比<90:1；**
/// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
/// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
/// - 图片文件链接支持的传输协议：HTTP、HTTPS；
/// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
/// - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
/// </summary>
/// <param name="req"><see cref="CreateImageModerationAsyncTaskRequest"/></param>
/// <returns><see cref="CreateImageModerationAsyncTaskResponse"/></returns>
public CreateImageModerationAsyncTaskResponse CreateImageModerationAsyncTaskSync(CreateImageModerationAsyncTaskRequest req)
{
return InternalRequestAsync<CreateImageModerationAsyncTaskResponse>(req, "CreateImageModerationAsyncTask")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms) 并调整好对应的业务配置。
/// ### 接口使用说明：
/// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
/// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
///
/// ### 接口功能说明：
/// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
/// - 支持对GIF图/长图进行截帧或拆分检测；
/// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
/// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
/// - 支持根据不同的业务场景配置自定义的审核策略；
/// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
/// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
///
/// ### 接口调用说明：
/// - 图片文件大小支持：**文件 < 5M**
/// - 图片默认尺寸支持：**长或者宽 >50分辨率**和**长或者宽<10000分辨率**
/// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
/// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
/// - 图片文件链接支持的传输协议：HTTP、HTTPS；
/// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
///
///
/// <div class="rno-api-explorer" style="margin-bottom:20px">
/// <div class="rno-api-explorer-inner">
/// <div class="rno-api-explorer-hd">
/// <div class="rno-api-explorer-title">
/// 关于版本迭代的描述
/// </div>
/// </div>
/// <div class="rno-api-explorer-body">
/// <div class="rno-api-explorer-cont">
/// <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
/// <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
/// </div>
/// </div>
/// </div>
/// </div>
/// </summary>
/// <param name="req"><see cref="ImageModerationRequest"/></param>
/// <returns><see cref="ImageModerationResponse"/></returns>
public Task<ImageModerationResponse> ImageModeration(ImageModerationRequest req)
{
return InternalRequestAsync<ImageModerationResponse>(req, "ImageModeration");
}
/// <summary>
/// 本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms) 并调整好对应的业务配置。
/// ### 接口使用说明：
/// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
/// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
///
/// ### 接口功能说明：
/// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
/// - 支持对GIF图/长图进行截帧或拆分检测；
/// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
/// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
/// - 支持根据不同的业务场景配置自定义的审核策略；
/// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
/// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
///
/// ### 接口调用说明：
/// - 图片文件大小支持：**文件 < 5M**
/// - 图片默认尺寸支持：**长或者宽 >50分辨率**和**长或者宽<10000分辨率**
/// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
/// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
/// - 图片文件链接支持的传输协议：HTTP、HTTPS；
/// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
///
///
/// <div class="rno-api-explorer" style="margin-bottom:20px">
/// <div class="rno-api-explorer-inner">
/// <div class="rno-api-explorer-hd">
/// <div class="rno-api-explorer-title">
/// 关于版本迭代的描述
/// </div>
/// </div>
/// <div class="rno-api-explorer-body">
/// <div class="rno-api-explorer-cont">
/// <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
/// <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
/// </div>
/// </div>
/// </div>
/// </div>
/// </summary>
/// <param name="req"><see cref="ImageModerationRequest"/></param>
/// <returns><see cref="ImageModerationResponse"/></returns>
public ImageModerationResponse ImageModerationSync(ImageModerationRequest req)
{
return InternalRequestAsync<ImageModerationResponse>(req, "ImageModeration")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
}
}