小牛翻译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

相关文章

如何在 Spring Boot 中实现 FreeMarker 模板

《如何在SpringBoot中实现FreeMarker模板》FreeMarker是一种功能强大、轻量级的模板引擎,用于在Java应用中生成动态文本输出(如HTML、XML、邮件内容等),本文... 目录什么是 FreeMarker 模板?在 Spring Boot 中实现 FreeMarker 模板1. 环

SpringMVC 通过ajax 前后端数据交互的实现方法

《SpringMVC通过ajax前后端数据交互的实现方法》:本文主要介绍SpringMVC通过ajax前后端数据交互的实现方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价... 在前端的开发过程中,经常在html页面通过AJAX进行前后端数据的交互,SpringMVC的controll

Java中的工具类命名方法

《Java中的工具类命名方法》:本文主要介绍Java中的工具类究竟如何命名,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录Java中的工具类究竟如何命名?先来几个例子几种命名方式的比较到底如何命名 ?总结Java中的工具类究竟如何命名?先来几个例子JD

Java Stream流使用案例深入详解

《JavaStream流使用案例深入详解》:本文主要介绍JavaStream流使用案例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录前言1. Lambda1.1 语法1.2 没参数只有一条语句或者多条语句1.3 一个参数只有一条语句或者多

Spring Security自定义身份认证的实现方法

《SpringSecurity自定义身份认证的实现方法》:本文主要介绍SpringSecurity自定义身份认证的实现方法,下面对SpringSecurity的这三种自定义身份认证进行详细讲解,... 目录1.内存身份认证(1)创建配置类(2)验证内存身份认证2.JDBC身份认证(1)数据准备 (2)配置依

SpringBoot整合OpenFeign的完整指南

《SpringBoot整合OpenFeign的完整指南》OpenFeign是由Netflix开发的一个声明式Web服务客户端,它使得编写HTTP客户端变得更加简单,本文为大家介绍了SpringBoot... 目录什么是OpenFeign环境准备创建 Spring Boot 项目添加依赖启用 OpenFeig

Java Spring 中 @PostConstruct 注解使用原理及常见场景

《JavaSpring中@PostConstruct注解使用原理及常见场景》在JavaSpring中,@PostConstruct注解是一个非常实用的功能,它允许开发者在Spring容器完全初... 目录一、@PostConstruct 注解概述二、@PostConstruct 注解的基本使用2.1 基本代

springboot使用Scheduling实现动态增删启停定时任务教程

《springboot使用Scheduling实现动态增删启停定时任务教程》:本文主要介绍springboot使用Scheduling实现动态增删启停定时任务教程,具有很好的参考价值,希望对大家有... 目录1、配置定时任务需要的线程池2、创建ScheduledFuture的包装类3、注册定时任务,增加、删

SpringBoot整合mybatisPlus实现批量插入并获取ID详解

《SpringBoot整合mybatisPlus实现批量插入并获取ID详解》这篇文章主要为大家详细介绍了SpringBoot如何整合mybatisPlus实现批量插入并获取ID,文中的示例代码讲解详细... 目录【1】saveBATch(一万条数据总耗时:2478ms)【2】集合方式foreach(一万条数

IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤及问题解决

《IntelliJIDEA中配置SpringMVC环境的详细步骤及问题解决》:本文主要介绍IntelliJIDEA中配置SpringMVC环境的详细步骤及问题解决,本文分步骤结合实例给大... 目录步骤 1:创建 Maven Web 项目步骤 2:添加 Spring MVC 依赖1、保存后执行2、将新的依赖