文字翻译

最近更新时间:2024-08-19 14:28:21

我的收藏

简介

本文档提供关于内容翻译的相关 API 概览以及 SDK 示例代码。
API
操作描述
提交一个翻译任务。

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API

提交任务

功能说明

提交一个翻译任务。
说明:
COS iOS SDK 版本需要大于等于 v6.2.9。

示例代码

Objective-C
QCloudPostTranslationRequest * request = [QCloudPostTranslationRequest new];
request.bucket = @"sample-1250000000";
request.regionName = @"COS_REGIONNAME";
request.input = [QCloudPostTranslation new];
// 创建任务的 Tag:Translation;是否必传:是
request.input.Tag = @"";
// 待操作的对象信息;是否必传:是
request.input.Input = [QCloudPostTranslationInput new];
// 源文档文件名单文件(docx/xlsx/html/markdown/txt):不超过800万字符有页数的(pdf/pptx):不超过300页文本文件(txt):不超过10MB二进制文件(pdf/docx/pptx/xlsx):不超过60MB图片文件(jpg/jpeg/png/webp):不超过10MB;是否必传:是
request.input.Input.Object = @"";
// 文档语言类型zh:简体中文zh-hk:繁体中文zh-tw:繁体中文zh-tr:繁体中文en:英语ar:阿拉伯语de:德语es:西班牙语fr:法语id:印尼语it:意大利语ja:日语pt:葡萄牙语ru:俄语ko:韩语km:高棉语lo:老挝语;是否必传:是
request.input.Input.Lang = @"";
// 文档类型pdfdocxpptxxlsxtxtxmlhtml:只能翻译 HTML 里的文本节点,需要通过 JS 动态加载的不进行翻译markdownjpgjpegpngwebp;是否必传:是
request.input.Input.Type = @"";
// 操作规则;是否必传:是
request.input.Operation = [QCloudPostTranslationOperation new];
// 翻译参数;是否必传:是
request.input.Operation.Translation = [QCloudPostTranslationTranslation new];
// 目标语言类型源语言类型为 zh/zh-hk/zh-tw/zh-tr 时支持:en、ar、de、es、fr、id、it、ja、it、ru、ko、km、lo、pt源语言类型为 en 时支持:zh、zh-hk、zh-tw、zh-tr、ar、de、es、fr、id、it、ja、it、ru、ko、km、lo、pt其他类型时支持:zh、zh-hk、zh-tw、zh-tr、en;是否必传:是
request.input.Operation.Translation.Lang = @"";
// 文档类型,源文件类型与目标文件类型映射关系如下:docx:docxpptx:pptxxlsx:xlsxtxt:txtxml:xmlhtml:htmlmarkdown:markdownpdf:pdf、docxpng:txtjpg:txtjpeg:txtwebp:txt;是否必传:是
request.input.Operation.Translation.Type = @"";
// 结果输出地址,当NoNeedOutput为true时非必选;是否必传:否
request.input.Operation.Output = [QCloudPostTranslationOutput new];
// 存储桶的地域;是否必传:是
request.input.Operation.Output.Region = @"";
// 存储结果的存储桶;是否必传:是
request.input.Operation.Output.Bucket = @"";
// 输出结果的文件名;是否必传:是
request.input.Operation.Output.Object = @"";
// 任务回调TDMQ配置,当 CallBackType 为 TDMQ 时必填。详情见 CallBackMqConfig;是否必传:否
request.input.CallBackMqConfig = [QCloudCallBackMqConfig new];
// 消息队列所属园区,目前支持园区 sh(上海)、bj(北京)、gz(广州)、cd(成都)、hk(中国香港);是否必传:是
request.input.CallBackMqConfig.MqRegion = @"";
// 消息队列使用模式,默认 Queue :主题订阅:Topic队列服务: Queue;是否必传:是
request.input.CallBackMqConfig.MqMode = @"";
// TDMQ 主题名称;是否必传:是
request.input.CallBackMqConfig.MqName = @"";

[request setFinishBlock:^(QCloudPostTranslationResponse * outputObject, NSError *error) {
// result:QCloudPostTranslationResponse 包含所有的响应;
// 具体查看代码注释或api文档:https://cloud.tencent.com/document/product/460/84799
}];
[[QCloudCOSXMLService defaultCOSXML] PostTranslation:request];

注意:
更多完整示例,请前往 GitHub 查看。
Swift
let request : QCloudPostTranslationRequest = QCloudPostTranslationRequest();
request.bucket = "sample-1250000000";
request.regionName = "COS_REGIONNAME";
let postTranslation : QCloudPostTranslation = QCloudPostTranslation();
request.input = postTranslation;
// 创建任务的 Tag:Translation;是否必传:是
request.input.tag = "Translation";
// 待操作的对象信息;是否必传:是
let input : QCloudPostTranslationInput = QCloudPostTranslationInput();
// 源文档文件名单文件(docx/xlsx/html/markdown/txt):不超过800万字符有页数的(pdf/pptx):不超过300页文本文件(txt):不超过10MB二进制文件(pdf/docx/pptx/xlsx):不超过60MB图片文件(jpg/jpeg/png/webp):不超过10MB;是否必传:是
request.input.input.object = "";
// 文档语言类型zh:简体中文zh-hk:繁体中文zh-tw:繁体中文zh-tr:繁体中文en:英语ar:阿拉伯语de:德语es:西班牙语fr:法语id:印尼语it:意大利语ja:日语pt:葡萄牙语ru:俄语ko:韩语km:高棉语lo:老挝语;是否必传:是
request.input.input.lang = "";
// 文档类型pdfdocxpptxxlsxtxtxmlhtml:只能翻译 HTML 里的文本节点,需要通过 JS 动态加载的不进行翻译markdownjpgjpegpngwebp;是否必传:是
request.input.input.type = "";
// 操作规则;是否必传:是
let operation : QCloudPostTranslationOperation = QCloudPostTranslationOperation();
// 翻译参数;是否必传:是
let translation : QCloudPostTranslationTranslation = QCloudPostTranslationTranslation();
// 目标语言类型源语言类型为 zh/zh-hk/zh-tw/zh-tr 时支持:en、ar、de、es、fr、id、it、ja、it、ru、ko、km、lo、pt源语言类型为 en 时支持:zh、zh-hk、zh-tw、zh-tr、ar、de、es、fr、id、it、ja、it、ru、ko、km、lo、pt其他类型时支持:zh、zh-hk、zh-tw、zh-tr、en;是否必传:是
request.input.operation = operation;
request.input.operation.translation = translation;
request.input.operation.translation.lang = "";
// 文档类型,源文件类型与目标文件类型映射关系如下:docx:docxpptx:pptxxlsx:xlsxtxt:txtxml:xmlhtml:htmlmarkdown:markdownpdf:pdf、docxpng:txtjpg:txtjpeg:txtwebp:txt;是否必传:是
request.input.operation.translation.type = "";
// 结果输出地址,当NoNeedOutput为true时非必选;是否必传:否
let output : QCloudPostTranslationOutput = QCloudPostTranslationOutput();
// 存储桶的地域;是否必传:是
request.input.operation.output.region = "";
// 存储结果的存储桶;是否必传:是
request.input.operation.output.bucket = "";
// 输出结果的文件名;是否必传:是
request.input.operation.output.object = "";
request.finishBlock = { result, error in
// result:QCloudPostTranslationResponse 包含所有的响应;
// 具体查看代码注释或api文档:https://cloud.tencent.com/document/product/460/84799
};
QCloudCOSXMLService.defaultCOSXML().postTranslation(request);

注意:
更多完整示例,请前往 GitHub 查看。