269 lines
13 KiB
C#
269 lines
13 KiB
C#
/*
|
||
* 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.Tmt.V20180321
|
||
{
|
||
|
||
using Newtonsoft.Json;
|
||
using System.Threading.Tasks;
|
||
using TencentCloud.Common;
|
||
using TencentCloud.Common.Profile;
|
||
using TencentCloud.Tmt.V20180321.Models;
|
||
|
||
public class TmtClient : AbstractClient{
|
||
|
||
private const string endpoint = "tmt.tencentcloudapi.com";
|
||
private const string version = "2018-03-21";
|
||
|
||
/// <summary>
|
||
/// Client constructor.
|
||
/// </summary>
|
||
/// <param name="credential">Credentials.</param>
|
||
/// <param name="region">Region name, such as "ap-guangzhou".</param>
|
||
public TmtClient(Credential credential, string region)
|
||
: this(credential, region, new ClientProfile())
|
||
{
|
||
|
||
}
|
||
|
||
/// <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 TmtClient(Credential credential, string region, ClientProfile profile)
|
||
: base(endpoint, version, credential, region, profile)
|
||
{
|
||
|
||
}
|
||
|
||
/// <summary>
|
||
/// 提供中文到英文、英文到中文两种语言的图片翻译服务，可自动识别图片中的文本内容并翻译成目标语言，识别后的文本按行翻译，后续会提供可按段落翻译的版本。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="ImageTranslateRequest"/></param>
|
||
/// <returns><see cref="ImageTranslateResponse"/></returns>
|
||
public async Task<ImageTranslateResponse> ImageTranslate(ImageTranslateRequest req)
|
||
{
|
||
JsonResponseModel<ImageTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = await this.InternalRequest(req, "ImageTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<ImageTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 提供中文到英文、英文到中文两种语言的图片翻译服务，可自动识别图片中的文本内容并翻译成目标语言，识别后的文本按行翻译，后续会提供可按段落翻译的版本。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="ImageTranslateRequest"/></param>
|
||
/// <returns><see cref="ImageTranslateResponse"/></returns>
|
||
public ImageTranslateResponse ImageTranslateSync(ImageTranslateRequest req)
|
||
{
|
||
JsonResponseModel<ImageTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = this.InternalRequestSync(req, "ImageTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<ImageTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 可自动识别文本内容的语言种类，轻量高效，无需额外实现判断方式，使面向客户的服务体验更佳。 <br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="LanguageDetectRequest"/></param>
|
||
/// <returns><see cref="LanguageDetectResponse"/></returns>
|
||
public async Task<LanguageDetectResponse> LanguageDetect(LanguageDetectRequest req)
|
||
{
|
||
JsonResponseModel<LanguageDetectResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = await this.InternalRequest(req, "LanguageDetect");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<LanguageDetectResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 可自动识别文本内容的语言种类，轻量高效，无需额外实现判断方式，使面向客户的服务体验更佳。 <br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="LanguageDetectRequest"/></param>
|
||
/// <returns><see cref="LanguageDetectResponse"/></returns>
|
||
public LanguageDetectResponse LanguageDetectSync(LanguageDetectRequest req)
|
||
{
|
||
JsonResponseModel<LanguageDetectResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = this.InternalRequestSync(req, "LanguageDetect");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<LanguageDetectResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 本接口提供上传音频，将音频进行语音识别并翻译成文本的服务，目前开放中英互译的语音翻译服务。
|
||
/// 待识别和翻译的音频文件可以是 pcm、mp3和speex 格式，pcm采样率要求16kHz、位深16bit、单声道，音频内语音清晰。<br/>
|
||
/// 如果采用流式传输的方式，要求每个分片时长200ms~500ms；如果采用非流式的传输方式，要求音频时长不超过8s。注意最后一个分片的IsEnd参数设置为1。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="SpeechTranslateRequest"/></param>
|
||
/// <returns><see cref="SpeechTranslateResponse"/></returns>
|
||
public async Task<SpeechTranslateResponse> SpeechTranslate(SpeechTranslateRequest req)
|
||
{
|
||
JsonResponseModel<SpeechTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = await this.InternalRequest(req, "SpeechTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<SpeechTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 本接口提供上传音频，将音频进行语音识别并翻译成文本的服务，目前开放中英互译的语音翻译服务。
|
||
/// 待识别和翻译的音频文件可以是 pcm、mp3和speex 格式，pcm采样率要求16kHz、位深16bit、单声道，音频内语音清晰。<br/>
|
||
/// 如果采用流式传输的方式，要求每个分片时长200ms~500ms；如果采用非流式的传输方式，要求音频时长不超过8s。注意最后一个分片的IsEnd参数设置为1。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="SpeechTranslateRequest"/></param>
|
||
/// <returns><see cref="SpeechTranslateResponse"/></returns>
|
||
public SpeechTranslateResponse SpeechTranslateSync(SpeechTranslateRequest req)
|
||
{
|
||
JsonResponseModel<SpeechTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = this.InternalRequestSync(req, "SpeechTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<SpeechTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 提供中文到英文、英文到中文的等多种语言的文本内容翻译服务， 经过大数据语料库、多种解码算法、翻译引擎深度优化，在新闻文章、生活口语等不同语言场景中都有深厚积累，翻译结果专业评价处于行业领先水平。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="TextTranslateRequest"/></param>
|
||
/// <returns><see cref="TextTranslateResponse"/></returns>
|
||
public async Task<TextTranslateResponse> TextTranslate(TextTranslateRequest req)
|
||
{
|
||
JsonResponseModel<TextTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = await this.InternalRequest(req, "TextTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<TextTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 提供中文到英文、英文到中文的等多种语言的文本内容翻译服务， 经过大数据语料库、多种解码算法、翻译引擎深度优化，在新闻文章、生活口语等不同语言场景中都有深厚积累，翻译结果专业评价处于行业领先水平。<br />
|
||
/// 提示：对于一般开发者，我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源 部分。
|
||
/// </summary>
|
||
/// <param name="req"><see cref="TextTranslateRequest"/></param>
|
||
/// <returns><see cref="TextTranslateResponse"/></returns>
|
||
public TextTranslateResponse TextTranslateSync(TextTranslateRequest req)
|
||
{
|
||
JsonResponseModel<TextTranslateResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = this.InternalRequestSync(req, "TextTranslate");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<TextTranslateResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 文本翻译的批量接口
|
||
/// </summary>
|
||
/// <param name="req"><see cref="TextTranslateBatchRequest"/></param>
|
||
/// <returns><see cref="TextTranslateBatchResponse"/></returns>
|
||
public async Task<TextTranslateBatchResponse> TextTranslateBatch(TextTranslateBatchRequest req)
|
||
{
|
||
JsonResponseModel<TextTranslateBatchResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = await this.InternalRequest(req, "TextTranslateBatch");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<TextTranslateBatchResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 文本翻译的批量接口
|
||
/// </summary>
|
||
/// <param name="req"><see cref="TextTranslateBatchRequest"/></param>
|
||
/// <returns><see cref="TextTranslateBatchResponse"/></returns>
|
||
public TextTranslateBatchResponse TextTranslateBatchSync(TextTranslateBatchRequest req)
|
||
{
|
||
JsonResponseModel<TextTranslateBatchResponse> rsp = null;
|
||
try
|
||
{
|
||
var strResp = this.InternalRequestSync(req, "TextTranslateBatch");
|
||
rsp = JsonConvert.DeserializeObject<JsonResponseModel<TextTranslateBatchResponse>>(strResp);
|
||
}
|
||
catch (JsonSerializationException e)
|
||
{
|
||
throw new TencentCloudSDKException(e.Message);
|
||
}
|
||
return rsp.Response;
|
||
}
|
||
|
||
}
|
||
}
|