小牛翻译API接口的开通及JAVA调用实例演示

2024-01-01 07:30

本文主要是介绍小牛翻译API接口的开通及JAVA调用实例演示,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

一、前言

二、服务开通

三、Java调用接口实例演示

1.文本翻译

1.代码展示

2.术语文本翻译

3.对照文本翻译 

4.注意事项

2.文档翻译

1.调用流程示意图

2.官网Demo详情(示例只有上传并翻译流程的)

3.注意(这里很容易出错)

4.官方开发文档

四、SDK的Java调用接口实例演示


一、前言

小牛翻译提供文本翻译+文档翻译的API接口:

支持454种语言互译(包括常见的中英日韩俄等语种)

支持多种常见文档类型(Word、PPT、PDF(不支持扫描件)、Excel)

另:每天提供免费的20万字符流量+100页文档页数(调用时需要)

二、服务开通

首先需要在官网注册一个账号,获取我们后续需要的【API-KEY】和【APPID】。

注:

调用文本翻译只需用【API-KEY】即可,

调用文档翻译是【API-KEY】和【APPID】都需要。

获取方式:

  1. 小牛翻译官网注册链接:小牛翻译开放平台 - 机器翻译找小牛
  2. 注册成功后登录【控制台】,在【个人中心】可以看到【API-KEY】和【APPID】

三、Java调用接口实例演示

1.文本翻译

1.代码展示
public static void main(String[] args) {RestTemplate restTemplate = new RestTemplate();String url = "https://api.niutrans.com/NiuTransServer/translation";//小牛api地址Map<String,Object> map = new HashMap();map.put("from","auto");//源语言设置为自动识别map.put("to","en");//目标语言map.put("apikey","这里要换成自己的apikey");//api密钥map.put("src_text","作业好难");//翻译文本ResponseEntity<String> stringResponseEntity = restTemplate.postForEntity(url, map, String.class);System.out.println(stringResponseEntity.getBody());//得到翻译内容}

得出翻译结果

{“tgt_text”:”Homework is so difficult”,“from”:”zh”;“to”:”en”;}
2.术语文本翻译
  •  如果不想添加术语库,但是还想用术语校正,也可以在翻译的时候把术语传进去

public static void main(String[] args) {RestTemplate restTemplate = new RestTemplate();String url = "https://api.niutrans.com/NiuTransServer/translation";Map<String, Object> map = new HashMap();map.put("from","zh");map.put("to","en");map.put("apikey","这里要换成自己的apikey");map.put("src_text","你好世界");map.put("dictflag",1);map.put("dict","{\"你好\":\"nihao\"}");ResponseEntity<String> stringResponseEntity = restTemplate.postForEntity(url, map, String.class);System.out.println(stringResponseEntity.getBody());}

 得到的结果就是把“你好”翻译成想要的字符串“nihao”啦

{"tgt_text": "Nihao World","from": "zh","to": "en","align": {"0": {"0": {"tgt": "Nihao World ","src": "你好世界"}}}
}
3.对照文本翻译 
  • 如果需要原文译文对照接口,就调用下面的接口

public static void main(String[] args) {RestTemplate restTemplate = new RestTemplate();String url = "https://api.niutrans.com/NiuTransServer/translationAlign";Map<String,Object> map = new HashMap();map.put("from","zh");map.put("to","en");map.put("apikey","你的apikey");map.put("src_text","你好世界!我爱祖国");ResponseEntity<String> stringResponseEntity = restTemplate.postForEntity(url, map, String.class);System.out.println(stringResponseEntity.getBody());}

 得出结果:

{"tgt_text": "Hello world! I love my motherland","from": "zh","to": "en","align": {"0": {"0": {"tgt": "Hello world! ","src": "你好世界!"},"1": {"tgt": "I love my motherland ","src": "我爱祖国"}}}
}
4.注意事项

每次文本请求的长度不要超过5000,不然会截取前5000个字符。

2.文档翻译

小牛翻译的文档翻译接口有两种方式:

①上传文件后,直接翻译
②先上传文件,获取文件页数,然后再用返回的fileNo调用翻译接口进行翻译

1.调用流程示意图

2.官网Demo详情(示例只有上传并翻译流程的)
public class NiuTransDocumentApiDemo {public static String BASE_URL = "https://api-doc.niutrans.com";public static String UPLOAD_TRANS_URL = BASE_URL + "/documentTransApi/uploadAndTrans";//上传并翻译接口public static String GET_INFO_URL = BASE_URL + "/documentTransApi/getInfo";//获取进度接口public static String INTERRUPT_URL = BASE_URL + "/documentTransApi/interrupt";// 终止翻译接口public static String  DOWNLOAD_URL = BASE_URL + "/documentTransApi/download";//下载文件接口public static String from = "原语语种,例如:zh";public static String to ="目标语语种,例如:en";public static String appId = "您的appId";//应用唯一标识,在'控制台->个人中心'中查看public static String apikey = "您的apikey";//在'控制台->个人中心'中查看public static String filePath = "C:\\Test.docx";//替换为你要翻译的文件路径public static String saveFilePath = "C:\\";//上传并翻译文件public static String uploadAndTrans(){TreeMap<String,Object> requestParamsMap = new TreeMap();requestParamsMap.put("from",from);requestParamsMap.put("to",to);authStrGenerate(requestParamsMap);requestParamsMap.put("file",new File(filePath));String response = null;try {response = HttpUtil.post(UPLOAD_TRANS_URL, requestParamsMap);} catch (Exception e) {e.printStackTrace();log.error("上传文档并翻译异常");}log.info("上传并翻译结果为:{}",response);JSONObject jsonObject = JSONUtil.parseObj(response);JSONObject dataObject = JSONUtil.parseObj(jsonObject.get("data"));return dataObject.get("fileNo").toString();}//获取文件信息public static JSONObject getDocumentInfo(String fileNo) {TreeMap<String, Object> requestParamsMap = new TreeMap<>();requestParamsMap.put("fileNo",fileNo);authStrGenerate(requestParamsMap);String response = null;try {response = HttpUtil.get(GET_INFO_URL, requestParamsMap);} catch (Exception e) {e.printStackTrace();log.error("获取文档信息异常");}log.info("文档信息为:{}",response);JSONObject jsonObject = JSONUtil.parseObj(response);return JSONUtil.parseObj(JSONUtil.toJsonStr(jsonObject.get("data")));}//终止翻译中的文件public static void interruptTrans(String fileNo) {TreeMap<String, Object> requestParamsMap = new TreeMap<>();requestParamsMap.put("fileNo",fileNo);authStrGenerate(requestParamsMap);String response = null;try {response = HttpUtil.get(INTERRUPT_URL, requestParamsMap);} catch (Exception e) {e.printStackTrace();}}//下载文件public static void downloadFile(String fileNo) {TreeMap<String,Object> requestParamsMap = new TreeMap();requestParamsMap.put("fileNo",fileNo);requestParamsMap.put("type",1);authStrGenerate(requestParamsMap);String url = DOWNLOAD_URL + "?" +HttpUtil.toParams(requestParamsMap);HttpUtil.downloadFile(url, FileUtil.file(saveFilePath));}//生成权限字符串public static void authStrGenerate(TreeMap<String,Object> requestParamsMap) {requestParamsMap.put("appId",appId);requestParamsMap.put("apikey",apikey);requestParamsMap.put("timestamp",System.currentTimeMillis()+"");StringBuilder requestParamsStr = new StringBuilder("");Set<String> keys = requestParamsMap.keySet();Iterator<String> iterator = keys.iterator();while (iterator.hasNext()) {String key = iterator.next();requestParamsStr.append("&").append(key).append("=").append(requestParamsMap.get(key));}String paramsStr = requestParamsStr.toString().replaceFirst("&", "");requestParamsMap.put("authStr",SecureUtil.md5(paramsStr));requestParamsMap.remove("apikey");}public static void main(String[] args) {String fileNo = uploadAndTrans();JSONObject documentInfo = getDocumentInfo(fileNo);while (Integer.parseInt(documentInfo.get("transStatus").toString()) == 103){documentInfo = getDocumentInfo(fileNo);try {Thread.sleep(3000);} catch (InterruptedException e) {e.printStackTrace();}}if(Integer.parseInt(documentInfo.get("transStatus").toString()) == 105){downloadFile(fileNo);}}
}
3.注意(这里很容易出错)

在接口调用时,计算authstr权限字符串的时候比较容易出错,担心出错就用Demo中的方法就可以了。

如果没有你所用语言的Demo,要仔细阅读authstr生成规则及注意事项~

4.官方开发文档

 文档翻译Demo直通车:小牛翻译开放平台 - 机器翻译找小牛

如果你使用的是java、c#,python ,官方有现成的例子,可以复制使用,也可以下载示例文件到本地。

四、SDK的Java调用接口实例演示

小牛翻译的文档翻译API接口也有java SDK的调用方式,不过目前是内部测试阶段,还没正式上线,需要拿到安装包后手动引入到自己的项目里,可以联系客服。

下面是一个调用SDK的参考示例:

public class TransNiuUtil {public static void main(String[] args) {SendRequestClient sendRequestClient = new DefaultSendRequestClient("appid","aopikey");UploadTransRequestBo uploadTransRequestBo = new UploadTransRequestBo();uploadTransRequestBo.setFile(new File("文件地址"));uploadTransRequestBo.setFrom("原语语种");uploadTransRequestBo.setTo("目标语语种");BaseResultVo<UploadTransResultVo> baseResultVo = sendRequestClient.uploadTrans(uploadTransRequestBo);System.out.println(JSONUtil.toJsonStr(baseResultVo));BaseResultVo<DocumentInfoResultVo> documentInfo = sendRequestClient.getDocumentInfo(baseResultVo.getData().getFileNo());System.out.println(JSONUtil.toJsonStr(documentInfo));while (documentInfo.getData().getTransStatus() != 105){documentInfo = sendRequestClient.getDocumentInfo(baseResultVo.getData().getFileNo());try {Thread.sleep(3000);} catch (InterruptedException e) {e.printStackTrace();}System.out.println(JSONUtil.toJsonStr(documentInfo));}DownloadRequestBo downloadRequestBo = new DownloadRequestBo();downloadRequestBo.setFileNo(baseResultVo.getData().getFileNo());downloadRequestBo.setType(1);downloadRequestBo.setSaveFilePath("F:\\");sendRequestClient.downloadFileOrBytes(downloadRequestBo);sendRequestClient.downloadFile(downloadRequestBo);System.out.println(System.currentTimeMillis());}
}

这篇关于小牛翻译API接口的开通及JAVA调用实例演示的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/558530

相关文章

java如何解压zip压缩包

《java如何解压zip压缩包》:本文主要介绍java如何解压zip压缩包问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java解压zip压缩包实例代码结果如下总结java解压zip压缩包坐在旁边的小伙伴问我怎么用 java 将服务器上的压缩文件解压出来,

SpringBoot中SM2公钥加密、私钥解密的实现示例详解

《SpringBoot中SM2公钥加密、私钥解密的实现示例详解》本文介绍了如何在SpringBoot项目中实现SM2公钥加密和私钥解密的功能,通过使用Hutool库和BouncyCastle依赖,简化... 目录一、前言1、加密信息(示例)2、加密结果(示例)二、实现代码1、yml文件配置2、创建SM2工具

Spring WebFlux 与 WebClient 使用指南及最佳实践

《SpringWebFlux与WebClient使用指南及最佳实践》WebClient是SpringWebFlux模块提供的非阻塞、响应式HTTP客户端,基于ProjectReactor实现,... 目录Spring WebFlux 与 WebClient 使用指南1. WebClient 概述2. 核心依

Spring Boot @RestControllerAdvice全局异常处理最佳实践

《SpringBoot@RestControllerAdvice全局异常处理最佳实践》本文详解SpringBoot中通过@RestControllerAdvice实现全局异常处理,强调代码复用、统... 目录前言一、为什么要使用全局异常处理?二、核心注解解析1. @RestControllerAdvice2

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Spring事务传播机制最佳实践

《Spring事务传播机制最佳实践》Spring的事务传播机制为我们提供了优雅的解决方案,本文将带您深入理解这一机制,掌握不同场景下的最佳实践,感兴趣的朋友一起看看吧... 目录1. 什么是事务传播行为2. Spring支持的七种事务传播行为2.1 REQUIRED(默认)2.2 SUPPORTS2

怎样通过分析GC日志来定位Java进程的内存问题

《怎样通过分析GC日志来定位Java进程的内存问题》:本文主要介绍怎样通过分析GC日志来定位Java进程的内存问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、GC 日志基础配置1. 启用详细 GC 日志2. 不同收集器的日志格式二、关键指标与分析维度1.

Java进程异常故障定位及排查过程

《Java进程异常故障定位及排查过程》:本文主要介绍Java进程异常故障定位及排查过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、故障发现与初步判断1. 监控系统告警2. 日志初步分析二、核心排查工具与步骤1. 进程状态检查2. CPU 飙升问题3. 内存

java中新生代和老生代的关系说明

《java中新生代和老生代的关系说明》:本文主要介绍java中新生代和老生代的关系说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、内存区域划分新生代老年代二、对象生命周期与晋升流程三、新生代与老年代的协作机制1. 跨代引用处理2. 动态年龄判定3. 空间分

Java设计模式---迭代器模式(Iterator)解读

《Java设计模式---迭代器模式(Iterator)解读》:本文主要介绍Java设计模式---迭代器模式(Iterator),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录1、迭代器(Iterator)1.1、结构1.2、常用方法1.3、本质1、解耦集合与遍历逻辑2、统一