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

2024-01-01 07:30
文章标签 java 接口 实例 调用 api 翻译 开通 演示 小牛

本文主要是介绍小牛翻译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整合Redis注解实现增删改查功能(Redis注解使用)

Spring Boot整合Redis注解实现增删改查功能(Redis注解使用)

《SpringBoot整合Redis注解实现增删改查功能(Redis注解使用)》文章介绍了如何使用SpringBoot整合Redis注解实现增删改查功能,包括配置、实体类、Repository、Se... 目录配置Redis连接定义实体类创建Repository接口增删改查操作示例插入数据查询数据删除数据更
阅读更多...
Java Lettuce 客户端入门到生产的实现步骤

Java Lettuce 客户端入门到生产的实现步骤

《JavaLettuce客户端入门到生产的实现步骤》本文主要介绍了JavaLettuce客户端入门到生产的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要... 目录1 安装依赖MavenGradle2 最小化连接示例3 核心特性速览4 生产环境配置建议5 常见问题
阅读更多...
Java使用Swing生成一个最大公约数计算器

Java使用Swing生成一个最大公约数计算器

《Java使用Swing生成一个最大公约数计算器》这篇文章主要为大家详细介绍了Java使用Swing生成一个最大公约数计算器的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一下... 目录第一步：利用欧几里得算法计算最大公约数欧几里得算法的证明情形 1：b=0情形 2：b>0完成相关代码第二步：加
阅读更多...
Java 的ArrayList集合底层实现与最佳实践

Java 的ArrayList集合底层实现与最佳实践

《Java的ArrayList集合底层实现与最佳实践》本文主要介绍了Java的ArrayList集合类的核心概念、底层实现、关键成员变量、初始化机制、容量演变、扩容机制、性能分析、核心方法源码解析、... 目录1. 核心概念与底层实现1.1 ArrayList 的本质1.1.1 底层数据结构JDK 1.7
阅读更多...
Java Map排序如何按照值按照键排序

Java Map排序如何按照值按照键排序

《JavaMap排序如何按照值按照键排序》该文章主要介绍Java中三种Map（HashMap、LinkedHashMap、TreeMap）的默认排序行为及实现按键排序和按值排序的方法,每种方法结合实... 目录一、先理清 3 种 Map 的默认排序行为二、按「键」排序的实现方式1. 方式 1：用 TreeM
阅读更多...
Java中流式并行操作parallelStream的原理和使用方法

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流（parallelStream）的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS
阅读更多...
Java中Redisson 的原理深度解析

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、
阅读更多...
SpringBoot基于注解实现数据库字段回填的完整方案

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代
阅读更多...
一篇文章彻底搞懂macOS如何决定java环境

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面：本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一：使用 which命令方法二：使用 Java_home工具（Apple 官方推荐）那问题来了，
阅读更多...
Java HashMap的底层实现原理深度解析

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述：HashMap的宏观结构二、核心数据结构解析1. 数组（桶数组）2. 链表节点（Node
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2