腾讯翻译 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 参数

Body 参数application/json

示例
{
    "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": {
        "RecognizeStatus": 0,
        "RequestId": "6e698139-615a-4d42-8dea-6bfada24e83c",
        "Seq": 0,
        "SessionUuid": "sid-1516105689129",
        "Source": "zh",
        "SourceText": "你好。",
        "Target": "en",
        "TargetText": "Hello."
    }
}
修改于 2022-09-15 08:18:53
上一页
参数类型
下一页
图片翻译
Built with