小牛翻译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使用protobuf-maven-plugin的插件编译proto文件详解

《java使用protobuf-maven-plugin的插件编译proto文件详解》:本文主要介绍java使用protobuf-maven-plugin的插件编译proto文件,具有很好的参考价... 目录protobuf文件作为数据传输和存储的协议主要介绍在Java使用maven编译proto文件的插件

Java中的数组与集合基本用法详解

《Java中的数组与集合基本用法详解》本文介绍了Java数组和集合框架的基础知识,数组部分涵盖了一维、二维及多维数组的声明、初始化、访问与遍历方法,以及Arrays类的常用操作,对Java数组与集合相... 目录一、Java数组基础1.1 数组结构概述1.2 一维数组1.2.1 声明与初始化1.2.2 访问

Javaee多线程之进程和线程之间的区别和联系(最新整理)

《Javaee多线程之进程和线程之间的区别和联系(最新整理)》进程是资源分配单位,线程是调度执行单位,共享资源更高效,创建线程五种方式:继承Thread、Runnable接口、匿名类、lambda,r... 目录进程和线程进程线程进程和线程的区别创建线程的五种写法继承Thread,重写run实现Runnab

Java 方法重载Overload常见误区及注意事项

《Java方法重载Overload常见误区及注意事项》Java方法重载允许同一类中同名方法通过参数类型、数量、顺序差异实现功能扩展,提升代码灵活性,核心条件为参数列表不同,不涉及返回类型、访问修饰符... 目录Java 方法重载(Overload)详解一、方法重载的核心条件二、构成方法重载的具体情况三、不构

Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

《Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式》本文详细介绍如何使用Java通过JDBC连接MySQL数据库,包括下载驱动、配置Eclipse环境、检测数据库连接等关键步骤,... 目录一、下载驱动包二、放jar包三、检测数据库连接JavaJava 如何使用 JDBC 连接 mys

SpringBoot线程池配置使用示例详解

《SpringBoot线程池配置使用示例详解》SpringBoot集成@Async注解,支持线程池参数配置(核心数、队列容量、拒绝策略等)及生命周期管理,结合监控与任务装饰器,提升异步处理效率与系统... 目录一、核心特性二、添加依赖三、参数详解四、配置线程池五、应用实践代码说明拒绝策略(Rejected

一文详解SpringBoot中控制器的动态注册与卸载

《一文详解SpringBoot中控制器的动态注册与卸载》在项目开发中,通过动态注册和卸载控制器功能,可以根据业务场景和项目需要实现功能的动态增加、删除,提高系统的灵活性和可扩展性,下面我们就来看看Sp... 目录项目结构1. 创建 Spring Boot 启动类2. 创建一个测试控制器3. 创建动态控制器注

Java操作Word文档的全面指南

《Java操作Word文档的全面指南》在Java开发中,操作Word文档是常见的业务需求,广泛应用于合同生成、报表输出、通知发布、法律文书生成、病历模板填写等场景,本文将全面介绍Java操作Word文... 目录简介段落页头与页脚页码表格图片批注文本框目录图表简介Word编程最重要的类是org.apach

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP

Knife4j+Axios+Redis前后端分离架构下的 API 管理与会话方案(最新推荐)

《Knife4j+Axios+Redis前后端分离架构下的API管理与会话方案(最新推荐)》本文主要介绍了Swagger与Knife4j的配置要点、前后端对接方法以及分布式Session实现原理,... 目录一、Swagger 与 Knife4j 的深度理解及配置要点Knife4j 配置关键要点1.Spri