赞
踩
大家好,我是herosunly。985院校硕士毕业,现担任算法研究员一职,热衷于机器学习算法研究与应用。曾获得阿里云天池比赛第一名,CCF比赛第二名,科大讯飞比赛第三名。拥有多项发明专利。对机器学习和深度学习拥有自己独到的见解。曾经辅导过若干个非计算机专业的学生进入到算法行业就业。希望和大家一起成长进步。
本文主要介绍了小牛翻译帮你轻松搞定图片和语音翻译,希望能对同学们有所帮助。
最近小徒弟公司接了个出海的项目,除了常规开发任务以外,还需要对图片和语音进行翻译。具体来说,图片翻译是对图片文件中的文字进行翻译,而语音翻译是将语音文件进行转写和翻译,输出译文文本文件。
在尝试了众多开源模型之后,虽然能够达到一定的效果,但效果却并不很如意。恰好个人前段时间使用了小牛翻译的API服务,官网链接为https://niutrans.com/,不仅简单易用,而且效果稳定,能够满足多样化的业务场景。
心动不如行动。让我来给大家系统讲解一下小牛翻译的图片和语音翻译的API服务的使用方法。
小牛翻译为我们提供了图片翻译功能,可自动识别图片文字并将其翻译为指定语言。该功能一共提供了4个API接口:①上传并翻译文件:该接口作用为上传待翻译的图片,小牛翻译接收到文件开始翻译,注意,该接口返回结果为翻译后生成文件的编号,而不是翻译结果。②查看文件信息:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们想查看翻译的进度等信息,可调用该接口。③终止文件翻译:第一个接口调用成功后,小牛翻译后台开始努力翻译,如果我们由于某种原因不想继续翻译,可调用该接口终止任务。④译文接口下载:第一个接口调用成功后,小牛翻译后台开始努力翻译,当翻译完成后,可以调用该接口下载返回成功后的文件。
接下来,我会带着大家逐个解析,如果不想详细了解,可快速跳转到完整代码示例获取全部代码。下面就我们一起见证下吧!
https://api.niutrans.com/v2/image/translate/upload
可在小牛翻译官网上点击右上方的控制台:
然后点击API应用,然后点击复制图片 API下的APPID,如下所示:
memoryId:选填,String,翻译记忆库ID,进入“控制台—>资源管理->翻译记忆”中查看
返回值说明:注意①该接口只是返回结果文件的编号,并不直接返回翻译后的结果。②下图状态码只截了部分,完整的状态码列表,可点击响应状态码查看:
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应用'中查看
# 生成权限字符串
def generate_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
# 上传并翻译
def translate():
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)
当调用上传并翻译文件接口后,小牛翻译开始执行翻译任务,此时可调用查看文件信息接口,查看翻译的进度,具体使用方法如下:
https://api.niutrans.com/v2/image/translate/status/{file_no}
,其中file_no为上传并翻译文件接口得到的fileNo
# 获取翻译进度
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" # 上传并翻译文件接口返回的文件编号
def generate_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
def get_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()
while True:
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}")
break
if trans_status == 104:
break
if trans_status == 106:
break
https://api.niutrans.com/v2/image/translate/download/{file_no}
,其中file_no为上传并翻译文件接口得到的fileNo可复用的完整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" # 上传并翻译文件接口返回的文件编号
def generate_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
# 译文下载
def download(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)
with open(new_file_path, "wb") as file:
file.write(response_content)
print("文件下载完成")
download(file_no)
https://api.niutrans.com/v2/image/translate/interrupt/{file_no}
,其中file_no为上传并翻译文件接口得到的fileNo
可复用的完整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" # 上传并翻译文件接口返回的文件编号
def generate_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
# 终止翻译 根据需求选择
def interrupt(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)
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应用'中查看
# 生成权限字符串
def generate_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
# 上传并翻译
def translate():
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()
# 获取翻译进度
def get_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()
# 译文下载
def download(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)
with open(new_file_path, "wb") as file:
file.write(response_content)
print("文件下载完成")
# 终止翻译 根据需求选择
def interrupt(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) # 如果想终止翻译,此时可以调用终止的api
while True:
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)
break
if trans_status == 104:
break
if trans_status == 106:
break
else:
print(response_data['msg'])
下面两张图分别是中翻英、英翻中的结果:
小牛翻译还为我们提供了语音翻译功能,可自动识别语音文件并将其翻译为指定语言。该功能同图片翻译一样,也提供了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。
除接口地址外,其他与图片翻译完全一样,这里就不一一介绍了,如需了解,可查看图片翻译一章。下面给出完整的代码示例及效果图,便于大家使用。
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应用'中查看
# 生成权限字符串
def generate_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
# 上传并翻译
def translate():
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()
# 获取翻译进度
def get_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()
# 译文下载
def download(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)
with open(new_file_path, "wb") as file:
file.write(response_content)
print("文件下载完成")
# 终止翻译 根据需求选择
def interrupt(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) # 如果想终止翻译,此时可以调用终止的api
while True:
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)
break
if trans_status == 104:
break
if trans_status == 106:
break
else:
print(response_data['msg'])
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。