简介
本文档提供关于内容翻译的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
提交一个翻译任务。 |
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];
注意:
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);
注意: