腾讯翻译 API
  1. API接口
腾讯翻译 API
  • 请求限制
  • 常见问题
  • 服务等级协议
  • 联系我们
  • 产品简介
    • 产品概述
    • 产品优势
    • 应用场景
  • 购买指南
    • 计费概述
    • 欠费说明
  • API 文档
    • 更新历史
    • 简介
    • API 概览
    • 数据结构
    • 错误码
    • 调用方式
      • 请求结构
      • 公共参数
      • 签名方法 v3
      • 签名方法
      • 返回结果
      • 参数类型
    • API接口
      • 语音翻译
        POST
      • 图片翻译
        POST
      • 文本翻译
        POST
      • 文件翻译结果查询
        POST
      • 文件翻译请求
        POST
      • 语种识别
        POST
      • 批量文本翻译
        POST
  1. API接口

语音翻译

POST

接口描述#

接口请求域名: tmt.tencentcloudapi.com 。
本接口提供上传音频,将音频进行语音识别并翻译成文本的服务,目前开放中英互译的语音翻译服务。
待识别和翻译的音频文件可以是 pcm、mp3和speex 格式,pcm采样率要求16kHz、位深16bit、单声道,音频内语音清晰。
如果采用流式传输的方式,要求每个分片时长200ms~500ms;如果采用非流式的传输方式,要求音频时长不超过8s。注意最后一个分片的IsEnd参数设置为1。
提示:对于一般开发者,我们建议优先使用SDK接入简化开发。SDK使用介绍请直接查看 5. 开发者资源部分。
默认接口请求频率限制:5次/秒。

错误码#

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码描述
FailedOperation.NoFreeAmount本月免费额度已用完,如需继续使用您可以在机器翻译控制台升级为付费使用。
FailedOperation.ServiceIsolate账号因为欠费停止服务,请在腾讯云账户充值。
FailedOperation.UserNotRegistered服务未开通,请在腾讯云官网机器翻译控制台开通服务。
InternalError内部错误。
InternalError.BackendTimeout后台服务超时,请稍后重试。
InternalError.ErrorUnknown未知错误。
InternalError.RequestFailed请求失败。
InvalidParameter参数错误。
InvalidParameter.DuplicatedSessionIdAndSeq重复的SessionUuid和Seq组合。
InvalidParameter.MissingParameter参数错误。
InvalidParameter.SeqIntervalTooLargeSeq之间的间隙请不要大于2000。
LimitExceeded超过配额限制。
LimitExceeded.LimitedAccessFrequency超出请求频率。
MissingParameter缺少参数错误。
UnauthorizedOperation.ActionNotFound请填写正确的Action字段名称。
UnsupportedOperation操作不支持。
UnsupportedOperation.AudioDurationExceed音频分片长度超过限制,请保证分片长度小于8s。
UnsupportedOperation.TextTooLong单次请求text超过长度限制,请保证单次请求⻓度低于2000。
UnsupportedOperation.UnSupportedTargetLanguage不支持的目标语言,请参照语言列表。
UnsupportedOperation.UnsupportedLanguage不支持的语言,请参照语言列表。
UnsupportedOperation.UnsupportedSourceLanguage不支持的源语言,请参照语言列表。

请求参数

Header 参数
X-TC-Action
string 
必需
操作的接口名称。本接口取值:SpeechTranslate。
示例值:
SpeechTranslate
X-TC-Region
string 
必需
地域参数,用来标识希望操作哪个地域的数据。接口接受的地域取值参考接口文档中输入参数公共参数 Region 的说明。注意:某些接口不需要传递该参数,接口文档中会对此特别说明,此时即使传递该参数也不会生效。
默认值:
ap-guangzhou
X-TC-Timestamp
integer 
必需
当前 UNIX 时间戳,可记录发起 API 请求的时间。例如 1529223702。注意:如果与服务器时间相差超过5分钟,会引起签名过期错误。
默认值:
1529223702
X-TC-Version
string 
必需
操作的 API 的版本。本接口取值:2018-03-21。
默认值:
2018-03-21
Authorization
string 
必需
HTTP 标准身份认证头部字段,例如: TC3-HMAC-SHA256 Credential=AKIDEXAMPLE/Date/service/tc3_request, SignedHeaders=content-type;host, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024 其中, - TC3-HMAC-SHA256:签名方法,目前固定取该值; - Credential:签名凭证,AKIDEXAMPLE 是 SecretId;Date 是 UTC 标准时间的日期,取值需要和公共参数 X-TC-Timestamp 换算的 UTC 标准时间日期一致;service 为产品名,通常为域名前缀,例如域名 cvm.tencentcloudapi.com 意味着产品名是 cvm。本产品取值为 tmt; - SignedHeaders:参与签名计算的头部信息,content-type 和 host 为必选头部; - Signature:签名摘要,计算过程详见文档。
X-TC-Token
string 
可选
安全凭证服务所颁发的临时安全凭证中的 Token,使用时需要将 SecretId 和 SecretKey 的值替换为临时安全凭证中的 TmpSecretId 和 TmpSecretKey。使用长期密钥时不能设置此 Token 字段。
X-TC-Language
string 
可选
指定接口返回的语言,仅部分接口支持此参数。取值:zh-CN,en-US。zh-CN 返回中文,en-US 返回英文。
默认值:
zh-CN
Body 参数application/json
SessionUuid
string 
语音ID
必需
一段完整的语音对应一个SessionUuid
Source
string 
音频中的语言类型
必需
zh:中文;en:英文
Target
string 
翻译目标语言类型
必需
zh:中文;en:英文
AudioFormat
integer 
音频格式
必需
pcm:146;speex:16779154;mp3:83886080
Seq
integer 
语音分片的序号
必需
从0开始
IsEnd
integer 
是否最后一片语音分片
必需
0-否,1-是
Data
string 
语音分片内容进行 Base64 编码后的字符串
必需
音频内容需包含有效并可识别的文本信息。
ProjectId
integer 
项目ID
可选
可以根据控制台-账号中心-项目管理中的配置填写,如无配置请填写默认项目ID:0
Mode
string 
识别模式
可选
该参数已废弃
TransType
integer 
翻译类型
可选
该参数已废弃
示例
{
    "SessionUuid": "sid-1516105689129",
    "Source": "zh",
    "Target": "en",
    "AudioFormat": 83886080,
    "Seq": 0,
    "IsEnd": 1,
    "Data": "%2F%2FtQxAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA......MGCwUAU4UeWgJDOGmC2JgzouqHJQBsZiKUicVTU5UGTZ6mVJYlri5s9geZdCjBnExqtEsaw%2F5rtShQ6UOkolgkGSpWK"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://tmt.tencentcloudapi.com' \
--header 'X-TC-Action: SpeechTranslate' \
--header 'X-TC-Region;' \
--header 'X-TC-Timestamp;' \
--header 'X-TC-Version;' \
--header 'Authorization;' \
--header 'X-TC-Token;' \
--header 'X-TC-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "SessionUuid": "sid-1516105689129",
    "Source": "zh",
    "Target": "en",
    "AudioFormat": 83886080,
    "Seq": 0,
    "IsEnd": 1,
    "Data": "%2F%2FtQxAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA......MGCwUAU4UeWgJDOGmC2JgzouqHJQBsZiKUicVTU5UGTZ6mVJYlri5s9geZdCjBnExqtEsaw%2F5rtShQ6UOkolgkGSpWK"
}'

返回响应

🟢200成功
application/json
Body
Response
object 
必需
SessionUuid
string 
请求的SessionUuid直接返回
必需
RecognizeStatus
integer 
语音识别状态
必需
1-进行中 0-完成
SourceText
string 
识别出的原文
必需
TargetText
string 
翻译出的译文
必需
Seq
integer 
第几个语音分片
必需
Source
string 
原语言
必需
Target
string 
目标语言
必需
VadSeq
integer 
客户端原始Seq值
可选
当请求的Mode参数填写bvad时,启动VadSeq。此时Seq会被设置为后台vad(静音检测)后的新序号,而VadSeq代表客户端原始Seq值
RequestId
string 
唯一请求 ID
必需
每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
示例
{
    "Response": {
        "RecognizeStatus": 0,
        "RequestId": "6e698139-615a-4d42-8dea-6bfada24e83c",
        "Seq": 0,
        "SessionUuid": "sid-1516105689129",
        "Source": "zh",
        "SourceText": "你好。",
        "Target": "en",
        "TargetText": "Hello."
    }
}
上一页
参数类型
下一页
图片翻译
Built with