大家好,我是herosunly。985院校硕士毕业,现担任算法研究员一职,热衷于机器学习算法研究与应用。曾获得阿里云天池比赛第一名,CCF比赛第二名,科大讯飞比赛第三名。拥有多项发明专利。对机器学习和深度学习拥有自己独到的见解。曾经辅导过若干个非计算机专业的学生进入到算法行业就业。希望和大家一起成长进步。
本文主要介绍了小牛翻译帮你轻松搞定图片和语音翻译,希望能对同学们有所帮助。
文章目录
1. 前言
最近小徒弟公司接了个出海的项目,除了常规开发任务以外,还需要对图片和语音进行翻译。具体来说,图片翻译是对图片文件中的文字进行翻译,而语音翻译是将语音文件进行转写和翻译,输出译文文本文件。
在尝试了众多开源模型之后,虽然能够达到一定的效果,但效果却并不很如意。恰好个人前段时间使用了小牛翻译的API服务,官网链接为https://niutrans.com/,不仅简单易用,而且效果稳定,能够满足多样化的业务场景。


心动不如行动。让我来给大家系统讲解一下小牛翻译的图片和语音翻译的API服务的使用方法。
2. 图片翻译python调用示例
小牛翻译为我们提供了图片翻译功能,可自动识别图片文字并将其翻译为指定语言。该功能一共提供了4个API接口:①上传并翻译文件:该接口作用为上传待翻译的图片,小牛翻译接收到文件开始翻译,注意,该接口返回结果为翻译后生成文件的编号,而不是翻译结果。②查看文件信息:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们想查看翻译的进度等信息,可调用该接口。③终止文件翻译:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们由于某种原因不想继续翻译,可调用该接口终止任务。④译文接口下载:第一个接口调用成功后,小牛翻译后台开始努力翻译,当翻译完成后,可以调用该接口下载返回成功后的文件。
接下来,我会带着大家逐个解析,如果不想详细了解,可快速跳转到完整代码示例获取全部代码。下面就我们一起见证下吧!
2.1 API逐步解析
2.1.1 上传并翻译文件接口
- 调用上传并翻译文件接口,开始执行翻译任务。 - 接口地址:
https://api.niutrans.com/v2/image/translate/upload- 请求方法:post- 传参方式:multipart/form-data- 请求参数: - file:必传,file类型,待翻译的文件,目前支持PNG、JPG、JPEG、BMP格式- from:必传,String类型,源语种缩写,目前支持中文简体(参数代码zh)、英文(参数代码en)、日语(参数代码ja)、韩语(参数代码ko)、俄语(参数代码ru)- to:必填,String类型,目标语种缩写,目前支持的语言同from- appId:必填,String类型,API应用标识,可在控制台-API应用页面获取
可在小牛翻译官网上点击右上方的控制台:
然后点击API应用,然后点击复制图片 API下的APPID,如下所示:
- timestamp:必填,String类型,时间戳(当前时间的毫秒数)
- authStr:必填,String类型,权限字符串,生成规则:①将apikey及发送的参数按照参数名ASCII码从小到大排序,并使用键值对的格式拼接成字符串paramStr;(apikey通过登录小牛翻译云平台,进入 【控制台 - API应用】 中查看,见下图);②将步骤①产生的字符串paramStr,使用MD5加密算法进行加密,得到权限字符串(authStr)的值;③将步骤②得到的值,赋值给字段authStr,跟着其他参数一起传入接口。下面我也会给出python代码实践哦。

- realmCode:选填,Integer,领域CODE码,如果不传,默认为0。0:通用;1:医药;2:专利
- termId:选填,String,术语词典库,进入“控制台—>资源管理->术语词典”中查看

- memoryId:选填,String,翻译记忆库ID,进入“控制台—>资源管理->翻译记忆”中查看

- 返回值说明:注意①该接口只是返回结果文件的编号,并不直接返回翻译后的结果。②下图状态码只截了部分,完整的状态码列表,可点击响应状态码查看:


- 可复用的完整Python代码如下,其中app_id和api_key需要在控制台复制得到。
import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
trans_url = api_url +"/v2/image/translate/upload"# 上传并翻译文件接口地址
file_path =r"image.jpg"# 待翻译的图片路径,根据自己实际情况修改
from_language ="zh"# 源语语种缩写
to_language ="en"# 目标语语种缩写
app_id ="xxx"# 在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看# 生成权限字符串defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
# 上传并翻译deftranslate():
files ={'file':open(file_path,'rb')}
data ={'from': from_language,'to': to_language,'appId': app_id,'timestamp':int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
response = requests.post(trans_url, files=files, data=data)return response.json()
translate_res = translate()print(translate_res)

2.1.2 查看文件信息
- 当调用上传并翻译文件接口后,小牛翻译开始执行翻译任务,此时可调用查看文件信息接口,查看翻译的进度,具体使用方法如下:- 接口地址:
https://api.niutrans.com/v2/image/translate/status/{file_no},其中file_no为上传并翻译文件接口得到的fileNo- 请求方法:get- 传参方式:Path Parameters和Query String Parameters- 请求path参数: - file_no:必填,String类型,上传并翻译文件接口得到的fileNo- 请求query参数: - appId:必填,String类型,API应用标识,可在控制台-API应用页面获取。详情参见上传并翻译文件接口说明。- timestamp:必填,String类型,时间戳(当前时间的毫秒数)。详情参见上传并翻译文件接口说明。- authStr:必填,String类型,权限字符串。详情参见上传并翻译文件接口说明。- 返回值说明:完整的状态码列表,可点击响应状态码查看


- 可复用的完整Python代码如下,其中app_id和api_key需要在控制台复制得到。
# 获取翻译进度import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
get_info_url = api_url +"/v2/image/translate/status/{file_no}"# 查看文件信息接口地址,{file_no}后续替换为结果文件编号
status ={101:"未翻译",102:"排队中",103:"翻译中",104:"翻译终止",105:"翻译成功",106:"翻译失败"}
app_id ="xxx"# 在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看
file_no ="niu-caceaff7507d2dcee346cxxxxxxxxx"# 上传并翻译文件接口返回的文件编号defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
defget_info(file_no):
params ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
get_info_url_new = get_info_url.format(file_no=file_no)
response = requests.get(get_info_url_new, params=params)return response.json()whileTrue:
time.sleep(5)# 查看翻译结果信息
response_json = get_info(file_no)if response_json["code"]==200:
data = response_json["data"]
trans_status = data["transStatus"]print(f"当前翻译的状态为{status.get(trans_status,'未知')}")if trans_status ==105:# 105说明翻译成功print(f"翻译完成,翻译后的具体信息为{response_json}")breakif trans_status ==104:breakif trans_status ==106:break

2.1.3 译文下载接口
- 当翻译完成后,调用该接口得到最终的结果文件,具体使用方法如下: - 接口地址:
https://api.niutrans.com/v2/image/translate/download/{file_no},其中file_no为上传并翻译文件接口得到的fileNo- 请求方法:get- 传参方式:Path Parameters和Query String Parameters- 请求path参数: - file_no:必填,String类型,上传并翻译文件接口得到的fileNo- 请求query参数: - type:必填,Interger类型,下载类型,0:原始文件,1:译文文件,2:双语对照文件- appId:必填,String类型,API应用标识,可在控制台-API应用页面获取。详情参见上传并翻译文件接口说明。- timestamp:必填,String类型,时间戳(当前时间的毫秒数)。详情参见上传并翻译文件接口说明。- authStr:必填,String类型,权限字符串。详情参见上传并翻译文件接口说明。- 返回类型:Blob
可复用的完整Python代码如下,其中app_id和api_key需要在控制台复制得到。
import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
download_url = api_url +"/v2/image/translate/download/{file_no}"# 译文下载接口地址,{file_no}后续替换为结果文件编号
app_id ="xxx"# 在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看
file_no ="niu-caceafabb691897c0d4b069bxxxxxxxx"# 上传并翻译文件接口返回的文件编号defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
# 译文下载defdownload(file_no):
params ={"type":1,"appId": app_id,"timestamp":int(time.time())}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
download_url_new = download_url.format(file_no=file_no)
response = requests.get(download_url_new, params=params)
response_content = response.content
file_name = response.headers.get("Content-Disposition").split("=")[1]
new_file_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), file_name)withopen(new_file_path,"wb")asfile:file.write(response_content)print("文件下载完成")
download(file_no)


- 为了让大家更直观地感受小牛翻译的效果,我又找了一张英文图片(Attention Is All You Need论文abstract),其翻译结果如下图所示:

2.1.4 终止文件翻译
- 在调用上传并翻译文件接口后,小牛翻译开始执行翻译任务,调用查询文件信息接口,如果翻译任务的状态为翻译中,而我们此时由于各种原因,不想继续翻译了,可以调用该接口,强制终止翻译。 - 接口地址:
https://api.niutrans.com/v2/image/translate/interrupt/{file_no},其中file_no为上传并翻译文件接口得到的fileNo- 请求方法:put- 传参方式:Path Parameters和Query String Parameters- 请求path参数: - file_no:必填,String类型,上传并翻译文件接口得到的fileNo- 请求query参数: - appId:必填,String类型,API应用标识,可在控制台-API应用页面获取。详情参见上传并翻译文件接口说明。- timestamp:必填,String类型,时间戳(当前时间的毫秒数)。详情参见上传并翻译文件接口说明。- authStr:必填,String类型,权限字符串。详情参见上传并翻译文件接口说明。- 返回类型:json,注意:下图状态码只截了部分,完整的状态码列表,可点击响应状态码查看


可复用的完整Python代码如下,其中app_id和api_key需要在控制台复制得到。
import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
interrupt_url = api_url +"/v2/image/translate/interrupt/{file_no}"
app_id ="xxx"# 在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看
file_no ="niu-caceaf969509a72201428exxxxx"# 上传并翻译文件接口返回的文件编号defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
# 终止翻译 根据需求选择definterrupt(file_no):
data ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
interrupt_url_new = interrupt_url.format(file_no=file_no)
response = requests.put(interrupt_url_new, data=data)
response_data = response.json()return response_data
response_data = interrupt(file_no)print(response_data)

2.2 完整代码示例
import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
trans_url = api_url +"/v2/image/translate/upload"# 上传并翻译文件接口地址
get_info_url = api_url +"/v2/image/translate/status/{file_no}"# 查看文件信息接口地址,{file_no}后续替换为结果文件编号
interrupt_url = api_url +"/v2/image/translate/interrupt/{file_no}"# 终止文件翻译接口地址,{file_no}后续替换为结果文件编号
download_url = api_url +"/v2/image/translate/download/{file_no}"# 译文下载接口地址,{file_no}后续替换为结果文件编号
status ={101:"未翻译",102:"排队中",103:"翻译中",104:"翻译终止",105:"翻译成功",106:"翻译失败"}
file_path =r"image.jpg"# 待翻译的图片路径,根据自己实际情况修改
from_language ="zh"# 必填,源语语种缩写,详见https://niutrans.com/documents/contents/multi_img#8
to_language ="en"# 必填,目标语语种缩写,详见https://niutrans.com/documents/contents/multi_img#8
app_id ="xxx"# 必填,小牛翻译图片翻译API应用标识,可在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看# 生成权限字符串defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
# 上传并翻译deftranslate():
files ={'file':open(file_path,'rb')}
data ={'from': from_language,'to': to_language,'appId': app_id,'timestamp':int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
response = requests.post(trans_url, files=files, data=data)return response.json()# 获取翻译进度defget_info(file_no):
params ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
get_info_url_new = get_info_url.format(file_no=file_no)
response = requests.get(get_info_url_new, params=params)return response.json()# 译文下载defdownload(file_no):
params ={"type":1,"appId": app_id,"timestamp":int(time.time())}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
download_url_new = download_url.format(file_no=file_no)
response = requests.get(download_url_new, params=params)
response_content = response.content
file_name = response.headers.get("Content-Disposition").split("=")[1]
new_file_path = os.path.join(os.path.dirname(file_path), file_name)withopen(new_file_path,"wb")asfile:file.write(response_content)print("文件下载完成")# 终止翻译 根据需求选择definterrupt(file_no):
data ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
interrupt_url_new = interrupt_url.format(file_no=file_no)
response = requests.put(interrupt_url_new, data=data)
response_data = response.json()return response_data
if __name__ =="__main__":# 调用翻译接口:上传文件,并翻译,得到翻译后的文件编号
response_data = translate()
code = response_data['code']print("翻译响应结果:", code)if code ==200:
file_no = response_data['data']['fileNo']# interrupt_data = interrupt(file_no) # 如果想终止翻译,此时可以调用终止的apiwhileTrue:
time.sleep(5)# 查看翻译结果信息
response_json = get_info(file_no)if response_json["code"]==200:
data = response_json["data"]
trans_status = data["transStatus"]print(f"当前翻译的状态为{status.get(trans_status,'未知')}")if trans_status ==105:# 105说明翻译成功print(f"翻译完成,翻译后的具体信息为{response_json}")# 下载翻译后的文件
download(file_no)breakif trans_status ==104:breakif trans_status ==106:breakelse:print(response_data['msg'])
下面两张图分别是中翻英、英翻中的结果:

3. 语音翻译python调用示例
小牛翻译还为我们提供了语音翻译功能,可自动识别语音文件并将其翻译为指定语言。该功能同图片翻译一样,也提供了4个API接口:①上传并翻译文件:该接口作用为上传待翻译的图片,小牛翻译接收到文件开始翻译,注意,该接口返回结果为翻译后生成文件的编号,而不是翻译结果。②查看文件信息:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们想查看翻译的进度等信息,可调用该接口。③终止文件翻译:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们由于某种原因不想继续翻译,可调用该接口终止任务。④译文接口下载:第一个接口调用成功后,小牛翻译后台开始努力翻译,当翻译完成后,可以调用该接口下载返回成功后的文件。
语音翻译四个接口的使用和图片翻译基本一致,只需要修改接口地址,具体为:①上传并翻译文件:
https://api.niutrans.com/v2/voice/translate/short-voice/upload
。②查询文件信息:
https://api.niutrans.com/v2/voice/translate/short-voice/status/{file_no}
。③终止文件翻译:
https://api.niutrans.com/v2/voice/translate/short-voice/interrupt/{file_no}
。④译文下载接口:
https://api.niutrans.com/v2/voice/translate/short-voice/download/{file_no}
。语音翻译当前支持MP3、WAV格式,支持语音时长60s,支持最大文件大小2M。
除接口地址外,其他与图片翻译完全一样,这里就不一一介绍了,如需了解,可查看图片翻译一章。下面给出完整的代码示例及效果图,便于大家使用。
- 可复用的完整Python代码如下,其中app_id和api_key需要在控制台复制得到。
import os
import requests
import time
import hashlib
api_url ="https://api.niutrans.com"# 小牛翻译官网
trans_url = api_url +"/v2/voice/translate/short-voice/upload"# 上传并翻译文件接口地址
get_info_url = api_url +"/v2/voice/translate/short-voice/status/{file_no}"# 查看文件信息接口地址,{file_no}后续替换为结果文件编号
interrupt_url = api_url +"/v2/voice/translate/short-voice/interrupt/{file_no}"# 终止文件翻译接口地址,{file_no}后续替换为结果文件编号
download_url = api_url +"/v2/voice/translate/short-voice/download/{file_no}"# 译文下载接口地址,{file_no}后续替换为结果文件编号
status ={101:"未翻译",102:"排队中",103:"翻译中",104:"翻译终止",105:"翻译成功",106:"翻译失败"}
file_path =r"translate.mp3"# 待翻译的语音文件路径,根据自己实际情况修改
from_language ="en"# 必填,源语语种缩写,详见https://niutrans.com/documents/contents/multi_img#8
to_language ="zh"# 必填,目标语语种缩写,详见https://niutrans.com/documents/contents/multi_img#8
app_id ="xxx"# 必填,小牛翻译语音翻译API应用标识,可在控制台-API应用页面获取
api_key ="xxx"# 在'控制台->API应用'中查看# 生成权限字符串defgenerate_auth_str(params):
sorted_params =sorted(list(params.items())+[('apikey', api_key)], key=lambda x: x[0])
param_str ='&'.join([f'{key}={value}'for key, value in sorted_params])
md5 = hashlib.md5()
md5.update(param_str.encode('utf-8'))
auth_str = md5.hexdigest()return auth_str
# 上传并翻译deftranslate():
files ={'file':open(file_path,'rb')}
data ={'from': from_language,'to': to_language,'appId': app_id,'timestamp':int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
response = requests.post(trans_url, files=files, data=data)return response.json()# 获取翻译进度defget_info(file_no):
params ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
get_info_url_new = get_info_url.format(file_no=file_no)
response = requests.get(get_info_url_new, params=params)return response.json()# 译文下载defdownload(file_no):
params ={"type":1,"appId": app_id,"timestamp":int(time.time())}
auth_str = generate_auth_str(params)
params['authStr']= auth_str
download_url_new = download_url.format(file_no=file_no)
response = requests.get(download_url_new, params=params)
response_content = response.content
file_name = response.headers.get("Content-Disposition").split("=")[1]
new_file_path = os.path.join(os.path.dirname(file_path), file_name)withopen(new_file_path,"wb")asfile:file.write(response_content)print("文件下载完成")# 终止翻译 根据需求选择definterrupt(file_no):
data ={"appId": app_id,"timestamp":int(time.time()),}
auth_str = generate_auth_str(data)
data['authStr']= auth_str
interrupt_url_new = interrupt_url.format(file_no=file_no)
response = requests.put(interrupt_url_new, data=data)
response_data = response.json()return response_data
if __name__ =="__main__":# 调用翻译接口:上传文件,并翻译,得到翻译后的文件编号
response_data = translate()
code = response_data['code']print("翻译响应结果:", code)if code ==200:
file_no = response_data['data']['fileNo']# interrupt_data = interrupt(file_no) # 如果想终止翻译,此时可以调用终止的apiwhileTrue:
time.sleep(5)# 查看翻译结果信息
response_json = get_info(file_no)if response_json["code"]==200:
data = response_json["data"]
trans_status = data["transStatus"]print(f"当前翻译的状态为{status.get(trans_status,'未知')}")if trans_status ==105:# 105说明翻译成功print(f"翻译完成,翻译后的具体信息为{response_json}")# 下载翻译后的文件
download(file_no)breakif trans_status ==104:breakif trans_status ==106:breakelse:print(response_data['msg'])

- 上图为中文语音翻译,下面再给一个英文语音翻译的效果: - 语音原始地址:https://www.kekenet.com/menu/200709/17963.shtml- 翻译结果如下:

版权归原作者 herosunly 所有, 如有侵权,请联系我们删除。