小牛翻译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 Security常见问题及解决方案

Spring Security常见问题及解决方案

《SpringSecurity常见问题及解决方案》SpringSecurity是Spring生态的安全框架,提供认证、授权及攻击防护,支持JWT、OAuth2集成,适用于保护Spring应用,需配置... 目录Spring Security 简介Spring Security 核心概念1. ​Securit
阅读更多...
SpringBoot+EasyPOI轻松实现Excel和Word导出PDF

SpringBoot+EasyPOI轻松实现Excel和Word导出PDF

《SpringBoot+EasyPOI轻松实现Excel和Word导出PDF》在企业级开发中,将Excel和Word文档导出为PDF是常见需求,本文将结合​​EasyPOI和​​Aspose系列工具实... 目录一、环境准备与依赖配置1.1 方案选型1.2 依赖配置（商业库方案）二、Excel 导出 PDF
阅读更多...
SpringBoot改造MCP服务器的详细说明(StreamableHTTP 类型)

SpringBoot改造MCP服务器的详细说明(StreamableHTTP 类型)

《SpringBoot改造MCP服务器的详细说明(StreamableHTTP类型)》本文介绍了SpringBoot如何实现MCPStreamableHTTP服务器,并且使用CherryStudio... 目录SpringBoot改造MCP服务器（StreamableHTTP）1 项目说明2 使用说明2.1
阅读更多...
spring中的@MapperScan注解属性解析

spring中的@MapperScan注解属性解析

《spring中的@MapperScan注解属性解析》@MapperScan是Spring集成MyBatis时自动扫描Mapper接口的注解,简化配置并支持多数据源,通过属性控制扫描路径和过滤条件,利... 目录一、核心功能与作用二、注解属性解析三、底层实现原理四、使用场景与最佳实践五、注意事项与常见问题六
阅读更多...
Spring的RedisTemplate的json反序列泛型丢失问题解决

Spring的RedisTemplate的json反序列泛型丢失问题解决

《Spring的RedisTemplate的json反序列泛型丢失问题解决》本文主要介绍了SpringRedisTemplate中使用JSON序列化时泛型信息丢失的问题及其提出三种解决方案,可以根据性... 目录背景解决方案方案一方案二方案三总结背景在使用RedisTemplate操作redis时我们针对
阅读更多...
Java中Arrays类和Collections类常用方法示例详解

Java中Arrays类和Collections类常用方法示例详解

《Java中Arrays类和Collections类常用方法示例详解》本文总结了Java中Arrays和Collections类的常用方法,涵盖数组填充、排序、搜索、复制、列表转换等操作,帮助开发者高... 目录Arrays.fill()相关用法Arrays.toString()Arrays.sort()A
阅读更多...
Spring Boot Maven 插件如何构建可执行 JAR 的核心配置

Spring Boot Maven 插件如何构建可执行 JAR 的核心配置

《SpringBootMaven插件如何构建可执行JAR的核心配置》SpringBoot核心Maven插件,用于生成可执行JAR/WAR,内置服务器简化部署,支持热部署、多环境配置及依赖管理... 目录前言一、插件的核心功能与目标1.1 插件的定位1.2 插件的 Goals（目标）1.3 插件定位1.4 核
阅读更多...
如何使用Lombok进行spring 注入

如何使用Lombok进行spring 注入

《如何使用Lombok进行spring注入》本文介绍如何用Lombok简化Spring注入,推荐优先使用setter注入,通过注解自动生成getter/setter及构造器,减少冗余代码,提升开发效... Lombok为了开发环境简化代码，好处不用多说。spring 注入方式为2种，构造器注入和setter
阅读更多...
使用zip4j实现Java中的ZIP文件加密压缩的操作方法

使用zip4j实现Java中的ZIP文件加密压缩的操作方法

《使用zip4j实现Java中的ZIP文件加密压缩的操作方法》本文介绍如何通过Maven集成zip4j1.3.2库创建带密码保护的ZIP文件,涵盖依赖配置、代码示例及加密原理,确保数据安全性,感兴趣的... 目录1. zip4j库介绍和版本1.1 zip4j库概述1.2 zip4j的版本演变1.3 zip4
阅读更多...
Java堆转储文件之1.6G大文件处理完整指南

Java堆转储文件之1.6G大文件处理完整指南

《Java堆转储文件之1.6G大文件处理完整指南》堆转储文件是优化、分析内存消耗的重要工具,：本文主要介绍Java堆转储文件之1.6G大文件处理的相关资料,文中通过代码介绍的非常详细,需要的朋友可... 目录前言文件为什么这么大？如何处理这个文件？分析文件内容（推荐）删除文件（如果不需要）查看错误来源如何避
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2