如何获取谷歌新闻API密钥(分步指南)
如何获取百度语音翻译API密钥(分步指南)
在数字媒体、软件开发及日常生活中,跨语言沟通的需求日益增长,实时准确的语音翻译功能因此变得极为重要。百度语音翻译API正是为此而生,它提供了强大的语音到语音的翻译服务,使得开发者能够轻松地将这一功能集成到自己的应用中,无论是移动应用、网页端还是其他数字平台,都能为用户提供流畅的跨语言交流体验。
本文将详细指导你如何获取百度语音翻译API的密钥。通过简单的注册和申请流程,你将能够轻松获得这一高效的翻译工具。一旦获得API密钥,你就可以开始在你的应用中集成百度语音翻译功能,实现用户语音的实时翻译。
1. 成为开发者
三步完成账号的基本注册与认证:
STEP1:点击百度AI开放平台导航右侧的控制台,选择需要使用的AI服务项。若为未登录状态,将跳转至登录界面,请您使用百度账号登录。
STEP2:首次使用,登录后将会进入开发者认证页面,请填写相关信息完成开发者认证。注:(如您之前已经是百度云用户或百度开发者中心用户,此步可略过)。
STEP3:通过控制台左侧导航,选择产品服务-人工智能,进入具体AI服务项的控制面板(如文字识别、人脸识别),进行相关业务操作。
2. 创建应用
账号登录成功,您需要创建应用才可正式调用AI能力。应用是您调用API服务的基本操作单元,您可以基于应用创建成功后获取的API Key及Secret Key,进行接口调用操作,及相关配置。
以人脸识别为例,您可按照下图所示的操作流程,完成创建操作。
两种入口只是展现形式不同,相关AI服务模块内容完全一样 点击上图中的「创建应用」,即可进入应用创建界面,如下图所示:
两种入口只是展现形式不同,相关AI服务模块内容完全一样 创建应用需填写的内容如下:
应用名称: 必填项,用于标识您所创建的应用的名称,支持中英文、数字、下划线及中横线,此名称一经创建完毕,不可修改;
接口选择: 必填项,每个应用可以勾选业务所需的所有AI服务的接口权限(仅可勾选具备免费试用权限的接口能力),应用权限可跨服务勾选,创建应用完毕,此应用即具备了所勾选服务的调用权限;
包名绑定: 选填项,如果您需要使用OCR、AR及语音客户端SDK服务(iOS/Android),需要绑定包名信息,以便生成授权License,上图中勾选了「通用文字识别」权限后,即展现此项。 注:人脸识别客户端SDK需要单独申请使用,无需在此配置;
应用描述: 必填项,对此应用的业务场景进行描述。
以上内容根据您的需要,填写完毕后,即可点击「立即创建」,完成应用的创建。应用创建完毕后,您可以点击左侧导航中的「应用列表」,进行应用查看,如下图红框部分所示:
两种入口只是展现形式不同,相关AI服务模块内容完全一致。
温馨提示:每项服务最多创建100个应用,同一账号下,每项服务都有一定请求限额,该限额所有应用共享。每项服务的请求限额可以在该服务控制台的概览页查看,通常包含调用量请求限额与QPS限额。
3. 获取密钥
在您创建完毕应用后,平台将会分配给您此应用的相关凭证,主要为AppID、API Key、Secret Key。以上三个信息是您应用实际开发的主要凭证,每个应用之间各不相同,请您妥善保管。下图为示例内容:
两种入口只是展现形式不同,相关AI服务模块内容完全一样。
4. 生成签名
您需要使用创建应用所分配到的AppID、API Key及Secret Key,进行Access Token(用户身份验证和授权的凭证)的生成,方法详见下方 Access Token获取,我们为您准备了几种常见语言的请求示例代码。
温馨提示:Access Token的有效期为30天(以秒为单位),请您集成时注意在程序中定期请求新的token。
5. 发送请求
请求说明
HTTP 方法:POST
请求 URL:https://aip.baidubce.com/rpc/2.0/mt/v2/speech-translation
URL 参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header 如下:
参数 | 值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
请求参数
Body中放置请求参数,参数详情如下:
字段名 | 类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
from | string | 是 | en | 源语言,具体参考语言列表 |
to | string | 是 | zh | 目标语言,具体考语言列表 |
voice | string | 是 | xxxx | 音频文件二进制数据,需使用base64编码,编码后的大小不能超过4MB |
format | string | 是 | pcm | 音频格式:pcm、wav。并不是所有语言都支持全部的音频编码格式,支持情况请参考接口限制中的说明。 |
请求示例
{
"from": "en",
"to": "zh",
"format":"pcm",
"voice": "xxxx"
}
返回说明
返回参数
- 正常返回
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
log_id | uint64 | 是 | 唯一的log id,用于问题定位 |
result | object | 是 | 结果消息体 |
result.source | string | 是 | 语音识别得到的原文 |
result.target | string | 是 | 翻译后的目标语言文本 |
result.target_tts | string | 是 | 译文 TTS,使用base64编码(注:若翻译后的目标语言文本字节数超过400,则不返回target_tts内容) |
正常返回示例
{
"result": {
"source": "今天天气不错。",
"target": "It's a nice day today.",
"target_tts": "//MoxAAKkFIkAUYQAP/BhAhB4ACMe2iHIIDXkCgY4Y/w///8H3/+wo7hj/1h8uf/OFHfKBgSBhX1J2xoG/AgBRvgURv9xpT///MoxBAQow68AYc4Afp//3df/+zqeYeKv/d55fcHIaCIFRGGwDwWN/+n/wnYqPLNdzzDf////0VTBucRJkiUNeci5FHXYgkR//MoxAgOwdboAYtQAPME+SCwioSvCmlQUzDrWPrNdft/////RTOlfSsrJVdp7FSJSKRHGtHGNkZS9/v+/8uv6+tAWYCNLqKj//MoxAgO0e7MAdAoAHImHOFtPXNwvwQc1qqLbeEBZ+rfT/9//3+3zNXUrlxgOOK1DOXjBBDHZp2XILJ///0JgVWkuVAXTgGv//MoxAcMEFa4AGseJISqCImpw6zIokOUU6xEJYKuq///i4liUsFA7cWJaMOA0eDv///96yWIlRL///rjP+2oBWxhGHy2Eo/0//MoxBERQUaplDCKcFKtlsxlm6JZl532Qvb2pKx1BCEdhc8MSGEPmC4BVfKDwu+KLTWA3TREMK9Gowuon+nrTQvyEDB0nv/z//MoxAcMeT6kAAhEcC70t361oV7L7v+r2Djoxw9CHxOHnC4tUJKBdUJkmRHv+z1Od8U3Id9GSEz5jHASBhoW/3/2xWHv5bII//MoxBALgHLEAFPQSGC8wEFDQIf1Xtu2eXCwRBgTDDFVvTjPeIO7///6qPuoV8F8Qpmd+IEYeSUSj3UEQAkdR1tfhQI31M36//MoxB0LaTbQAIrEcH+dv7byq4g1///Hsd///6xtupJBzUJ/A5KViVV2NwXQlEOe5zWSQOAWHzXshwl1ncI+e2NRgq7//8rb//MoxCoL+Iq8AJvQTP//9JJcROpaBiJCAXowJ7XfyEkWmhnBV9gwAgaLHNvmn+Umkzq9/8Hz84TOZAuDhn///////2dNV/nH//MoxDUMaLLMAJMYTNSY6ARR0rt+UEM6L+SQIMtSpzkAwDyKt0EAL+gqY3U4cAwspEYTBxzL///9/+z/Y3Qq/SBBhAxmmrUI//MoxD4NCQ7YyoLKcOQ+sJsp1cwGHS+gdb6hjfEStXqJAYwlQf7e3u7rRp92/R/8tqHV/ghgHLiyOry4KG7rCalxuyQ7jdXq//MoxEQLmQrQAItKcC83O6zunas7eVcUDJxJxDWWqU9oQNEpns//4iX9/vVZ4QbAesg8UO3bVj9QmJXG+ZwFFS24suJQ6rd///MoxFAMIKbMAJqaTKcWBo8kQ6Yldnb8Gnh0Gn///+3htR3n5hgYdhQ0brnoSkl9Nd+tzjv/+r72t/qc8579b3WL/r9HcfpP//MoxFoM4IqwAMvKTIqk40PhAAE1l8hr////0/7/6ezfbui7OdJU2feUxUve0wzqU6OVO2VDlS32Mrtfrp7XORaGZ2o9Fcy0//MoxGELYC6oygjeALp1YEpnZAo57FIHHhCKdBFHEAkbBA57E5/0m/+ediEBZ/XDSskiO59/On/+fab3PxBX/85Z9hGHBhkW//MoxG4QGx6kAUEQAKk89R//5BgeS48UoIGRbmULtR1f///jTyxez46LcP3WGWZoq6yhv/////aWlQY/y4gCJe/b1RqFfRwB//MoxGgX6yKYAYVAAKYXZBt9zVTYAiTDBgyI4iK7qrqakmbVGS78x/f/nP+Y5yMupx5pDZVQePVcaMymIrlRqQNhOHGjjiIV//MoxEMXywLQAY84AZrIfczYxJpqN/N3/76M6mOYZQ23qynt09pQk4mq2zv/Mfw/x/KiAAlQvn+ayEwHaXFljRtqcuV6/zgO//MoxB4SWardlc8oADjP2FxUvVzfX///RN//RXMpWaS0qncUHgqUSWWpLn9X/+6gDiQw9jVnmfLVMrv/8Pw+ibBVmy00pwLh//MoxA8QyrbZlInKuMpL6AAmt46X+eJT+rft+n6fr+r/VDP1DQ6yJcLM/uLP/9UN7p9XX////nYqtEBwNHp/L8mqJrz8Mfw9//MoxAYOUbrllU0oADL4gYSI0c1ZMd4RYeBo2oe34x/qP/b/////6f/qUXX0A/qIi/Emszofu//lm4Mvw3qdhyqaQ93Kfug9//MoxAcM2Yq8AZg4ACttfM7EMS4q6bHe+eR9sedfvZv/////5wpBd//g6Ko4pYe26757//8iJip5Vfj0+Zs6cCVjVk18P2d2//MoxA4QUsbcAY8oALYYc/a+xzrev5////Vzkay1/R7K/v/tV/0SnsjHkJo8rKYSFhrU/ldp/0z4s7CRRoliGtX/59w4FeMd//MoxAcNiUrgAY8QALBiREmcxhrByuMQ7hqriKoJkMz3t10r9Kp6/7DnTUM5JR3SieP7EN0f3//d/6/1qtt023apSAIs6hVG//MoxAsPiWrIAZgoAJ+Zx7pDTWZZTkejwUHJ/mkGf+UDqZvp+2zkT/+ICouKAM7/lggThD/8MYIPKf/8wahipNX5rXemIKGC//MoxAcM0VbQAc8QAFz+YabrpjXlawt2f2N84zj/b7gif///f6U6OlhlGWDIOb0ofC3PmDDv///61Rbvh+oig2B7t5oig4Jv//MoxA4MAdLgymnElc0dByAeEjbNJmfs////6/qmQj2YcQoccqqjUp/3tQpwcVUCKKqkoD/BiEy/jAQ30hVAyYz9TS7fsXb+//MoxBkNIebhlGqEmL/n/uz/nCHNlQyA7b0RTfqh8mqlEC2P0+n/+aX6isE/AFYzbso4SVqM4iCsBo2fnb7GMeYd/////6/Z//MoxB8MGeLYAGnEmNENKFCK2qqik8ZLPWEMUFS1av/+iwH2ThfhzZY30EVbQUHgKBSi7nYz/T///////+vR2UrPBvs6MzEO//MoxCkMuc7UAHlElKkGVSjR/////yv1gnI4xZKDKEZlptChRNyAyqV2HCsuv1////////7OhWNMBFQyHEiToWUWpUUQqBLt//MoxDELwebIAJCEmLa7AayDAf/4Qgf6rjtrOX5/TGLSaxrwsH2A2MXHxShX//zHLdeRbHkTAUe/////fSq4Q00jNepxMUDu//MoxD0MmGMWX08YArRm1Ir0k5W/zTHOczQoNTDh4fXG1Ka/dP///6HneqG3WjyLocgkg9DJvnMaWO5637v/04SuVzk2l9El//MoxEUPOb6oAZg4AAUoGUhTmnUNVsXX////zX1UBUgwEdDsSuxEDR3Bo9wah2JToldK//BUNExBTUUzLjk5LjWqqqqqqqqq//MoxEMMeJJYAc8YAKqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq//MoxEwAAANIAAAAAKqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq"
},
"log_id": 1413395986911332328
}
- 异常返回
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
log_id | uint64 | 是 | 唯一的log id,用于问题定位 |
error_msg | string | 是 | 错误消息体 |
error_code | uint64 | 是 | 错误码 |
异常返回示例
{
"log_id": 1413409052597883633,
"error_msg": "internal error",
"error_code": 282000
}
错误码列表
接口流控及鉴权错误码
错误码 | 错误信息 | 描述 | 解决方法 |
---|---|---|---|
1 | Unknown error | 未知错误 | 请重试 |
2 | Service temporarily unavailable | 服务处理超时 | 请重试 |
4 | Open api request limit reached | 集群超限额 | 请重试 |
6 | no permission to access data | 没有接口权限 | 请确认您调用的接口已经被赋权。企业认证生效时间为1小时左右,使用需要企业认证的服务,请等待生效后重试 |
18 | Open api qps request limit reached | QPS超限额 | 请降低您的调用频率 |
19 | Open api total request limit reached | 请求总量超限额 | 请检查当前可用字符/次数包额度 |
100 | Invalid parameter | token拉取失败,无效的access_token参数 | 参考“Access Token” 重新获取 |
110 | Access token invalid or no longer valid | Access Token失效 | token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token |
111 | Access token expired | Access token过期 | token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token |
通用及业务错误码
错误码 | 错误信息 | 解决方法 |
---|---|---|
10001 | 必填参数为空或固定参数有误 | 检查参数是否误传 |
10004 | 访问频率受限 | 请降低您的调用频率 |
20000 | 语言方向不支持 | 检查源语种或目标语种是否在语言列表里 |
20200 | 语音翻译请求失败 | 请重试 |
20201 | 音频base64编码后数据大小超过4M限制 | 请上传符合大小要求的音频数据 |
20202 | 文件格式不支持 | 请上传符合格式要求的音频数据 |
216100 | invalid param | 用户请求中的参数不合法 |
216110 | appid not exist | appid不存在 |
216202 | input oversize | 用户请求体过大 |
282003 | missing required parameter(s) | 请用户请求中缺少必填参数 |
282000 | internal error | 内部错误,请稍后重试或发工单反馈 |
6. 鉴权认证机制
1. 获取AK/SK
当您成功创建应用后,在对应产品页签下选择“应用列表”,可查看已创建的应用。
平台将会分配给您此应用的相关凭证,主要为AppID、API Key、Secret Key。以上三个信息是您应用实际开发的重要凭证,每个应用各不相同,为了您的财产和服务安全请您妥善保管。
2. 获取 Access_token
百度AI开放平台使用OAuth2.0授权调用开放API,调用API时必须在URL中带上Access_token参数,Access token默认有效期为30天,获取Access_token的流程如下:
请求URL数据格式
向授权服务地址https://aip.baidubce.com/oauth/2.0/token
发送请求(推荐使用POST),并在URL中带上以下参数:
- grant_type: 必须参数,固定为
client_credentials
; - client_id: 必须参数,应用的
API Key
; - client_secret: 必须参数,应用的
Secret Key
;
例如:
https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq5eR3LT0vuXV4&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2&
获取Access_token的两种方式
接下来为您提供两种获取Access_token的方法,您可以按照自己的需求进行选择。
方式一:通过代码的形式获取Access_token
以下为您提供示例代码。这里以python语言为例进行演示。
- 打开python编译器,输入Access_token示例代码【python】。
import requests
import json
def main():
url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=xxxxxx&client_secret=xxxxx"
payload = ""
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
if __name__ == '__main__':
main()
- 在【官网获取的AK】和【官网获取的SK】中输入创建应用后获取的AK、SK。
- 输入完成后运行代码,服务器将返回json文本参数,如下:
- access_token:要获取的Access Token;
- expires_in:Access Token的有效期(秒为单位,有效期30天);
- 其他参数忽略,暂时不用;
- 若请求错误,服务器将返回的JSON文本包含以下参数:
- error: 错误码;关于错误码的详细信息请参考下方鉴权认证错误码。
- error_description: 错误描述信息,帮助理解和解决发生的错误。
例如,认证失败返回:
{
"error": "invalid_client",
"error_description": "unknown client id"
}
鉴权认证错误码
error | error_description | 解释 |
---|---|---|
invalid_client | unknown client id | API Key不正确 |
invalid_client | Client authentication failed | Secret Key不正确 |
方式二:使用网页调试工具获取Access_token
依次在网页调试工具中输入:
- grant_type: 必须参数,固定为
client_credentials
; - client_id: 必须参数,应用的
API Key
; - client_secret: 必须参数,应用的
Secret Key
;
具体的参数,您可以在控制台应用列表中看到,如果您还不熟悉,请您查看上一步“获取AK/SK”。
输入完成后,点击send,返回json字符串,获取Access_token。例如图中获取的access_token为24.a7179f3da2d56a81d0af25931c67efee.2592000.1627131472.282335-24130966
。
7. 常见问题
Q:如何百度语音翻译 API
A:幂简集成是国内领先的API集成管理平台,专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API:通过关键词搜索API(例如,输入’百度语音翻译 API‘这类品类词,更容易找到结果)、或者从API hub分类页进入寻找。
Q:每个服务的请求配额都是免费的么?
A:目前我们为每个账户下的每项API服务,都设置了固定的免费请求配额,便于您体验服务及应用调试。在免费试用阶段,成功调用或失败调用都算做一次有效调用,会消耗免费测试资源。
Q:每个服务的请求配额有限制么?
A:目前在同一账号下,您可以在对应服务的控制台中查看。付费服务不限请求数量,即用即扣。
Q:QPS超限怎么办?
A:QPS超限可以根据您的需求,进行购买。
价目表包含:免费测试资源、计费简介、计费价目表、费用列举等。
Q:支持哪些语言的服务端SDK?
A:目前支持各项服务的Java、PHP、Python、C#、Node.js版本服务端SDK,部分技术推出了C++、IOS、Android等版本服务端SDK,详情请参见各技术服务SDK文档。
Q:邀测、公测和商用接口有什么区别吗?
A:邀测的全称是邀请测试。AI能力引擎刚推出之际,邀请用户小范围测试。只有经过邀测后,才能进行公测,您需要提交工单申请或者直接通过产品页面进行商务咨询;公测的全称是公开测试。AI能力引擎向平台所有用户开放,提供一定的免费调用额度。同时,支持用户提交工单进行免费测试资源提额申请;商用是指AI能力引擎向平台所有用户开放,并收取一定费用。平台为用户提供一定的免费测试量。
Q:百度语音翻译 API 的替代品有哪些?
提供语音翻译 API的服务商除百度语音翻译 API,还有其他替代服务商也提供类似api服务,例如:
Text to Speech、Azure 语音翻译、实时语音翻译-有道
更多竞品可以在幂简集成开放平台中找到。
Q:百度语音翻译 API这个密钥还适用于哪些api?
8. 总结
本文总结了获取百度语音翻译 API密钥的详细步骤,从申请百度账号到成为开发者,再到获取服务密钥并进行可用性测试,为开发者提供了实用的指南。同时,还探讨了在使用API过程中需要考虑的关键因素,如鉴权认证机制、Access_token获取方式等,帮助开发者更有效地集成该能力到应用中。