You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/视频 AI 应用/服务端 OpenAPI/AI 视频翻译/字幕句段管理/GenerateAITranslationUtteranceAudio - 生成 AI 翻译文本音频
GenerateAITranslationUtteranceAudio - 生成 AI 翻译文本音频
最近更新时间：2025.09.12 15:51:22首次发布时间：2025.08.21 16:09:23
复制全文
我的收藏
有用
有用
无用
无用

调用 UpdateAITranslationUtterances 接口传入 AI 翻译生成文本的 UtteranceId，生成对应的音频。

注意事项

  • 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

  • 请求方式：POST
  • 请求地址：https://vod.volcengineapi.com?Action=GenerateAITranslationUtteranceAudio&Version=2025-01-01

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数
类型
是否必选
示例值
描述
Action
String
是
GenerateAITranslationUtteranceAudio
接口名称。当前 API 的名称为 GenerateAITranslationUtteranceAudio。
Version
String
是
2025-01-01
接口版本。当前 API 的版本为 2025-01-01。

Body

参数
类型
是否必选
示例值
描述
SpaceName
String
是
test

点播空间名。您可通过以下方式获取空间名称：

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。
ProjectId
String
是
684038d6b71***05b266fefe

项目 ID。您可通过以下方式获取项目 ID：

UtteranceId
String
是
utt_1234567890abcdef

文本 ID，可调用 GetAITranslationProject 接口获取，返回参数中的 TargetUtterances（目标语言文本信息）包含此字段。

注意

仅在提交 AI 翻译任务时选择了语音翻译时生效，且仅支持传入 TargetUtterances 的 UtteranceId。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数
类型
示例值
描述
ProjectBaseInfo
Object
-
项目基础信息
ProjectId
String
684038d6***c9005b266fefe
项目 ID
ProjectVersion
String
01c4fa5da***48a588a46f81e282b100
项目版本
TargetClip
Object
-
生成的片段信息，其中 ClipAudio 参数会返回新生成的音频信息
Id
String
68403b65ef364cc4835c810b
片段 ID
Trim
Object
-
片段时间信息
Start
Integer
200
开始时间，单位为毫秒
End
Integer
1100
结束时间，单位为毫秒
Volume
Integer
100
音量，取值范围为 0-100
ClipAudio
Object
-
片段音频信息
IsAudio
Boolean
true
是否为音频
Uri
String
tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4
文件存储路径
Vid
String
v0299fg***4d103gsqljht10tatbreg
文件 Vid。仅在 InputVideo 和 OutputVideo 中此字段有值。
DurationSecond
Double
159.104
文件时长，单位为秒
Url
String
https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4
文件访问 URL
FileName
String
video.mp4
文件路径，可用于拼接访问地址。
ClipVideo
Object
-
片段视频信息
IsAudio
Boolean
true
是否为音频
Uri
String
tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4
文件存储路径
Vid
String
v0299fg***4d103gsqljht10tatbreg
文件 Vid。仅在 InputVideo 和 OutputVideo 中此字段有值。
DurationSecond
Double
159.104
文件时长，单位为秒
Url
String
https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4
文件访问 URL
FileName
String
video.mp4
文件路径，可用于拼接访问地址。
TranslationType
String
source

片段翻译类型，取值如下：

  • source: 源语言、
  • target: 目标语言
  • background: 背景
TrackId
String
68403b65ef364cc4835c80fa
轨道 ID

请求示例

POST https://vod.volcengineapi.com?Action=GenerateAITranslationUtteranceAudio&Version=2025-01-01
{
  "ProjectId": "684038d6b71***05b266fefe",
  "SpaceName": "test",
  "UtteranceId": "utt_1234567890abcdef"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GenerateAITranslationUtteranceAudio",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectBaseInfo": {
      "ProjectId": "684038d6***c9005b266fefe",
      "ProjectVersion": "01c4fa5da***48a588a46f81e282b100"
    },
    "TargetClip": {
      "Id": "68403b65ef364cc4835c810b",
      "Trim": {
        "End": 1100,
        "Start": 200
      },
      "Volume": 100,
      "TrackId": "68403b65ef364cc4835c80fa",
      "ClipAudio": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "DurationSecond": 159.104
      },
      "ClipVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "DurationSecond": 159.104
      },
      "TranslationType": "source"
    }
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。

SDK

视频点播为 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API。本接口仅 VOD SDK 2.0 支持，详见 V2.0 SDK 介绍与迁移说明。