You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/视频 AI 应用/服务端 OpenAPI/AI 视频翻译/字幕句段管理/UpdateAITranslationUtterances - 更新 AI 翻译项目字幕文本
UpdateAITranslationUtterances - 更新 AI 翻译项目字幕文本
最近更新时间：2025.10.31 12:03:30首次发布时间：2025.07.30 14:22:39
复制全文
我的收藏
有用
有用
无用
无用

调用 UpdateAITranslationUtterances 接口更新指定 AI 翻译任务的字幕文本。

使用说明

当 AI 翻译任务处于暂停状态或已经执行完成时，您可调用此接口来更新字幕内容。

  • 对于暂停中的任务：更新字幕后，您需要调用 ContinueAITranslationWorkflow 接口恢复任务，系统将使用您更新后的字幕继续执行后续的语音合成等流程。
  • 对于已完成的任务：更新字幕后，您需要调用 RefreshAITranslationProject 接口重新生成视频，系统会应用您的修改并导出一个新的视频。

您可以根据 UpdateType 参数选择以下两种更新方式：

  • 通过文件更新：上传新的字幕文件（SRT/WebVTT），整体替换源语言、目标语言或双语字幕。此方式适用于大规模或整体性修改。
  • 通过句段 ID 更新：通过传入字幕句段的 ID，精确修改单条或多条字幕的文本内容、时间轴、说话人或音量。此方式适用于局部微调。

注意事项

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

请求说明

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

调试

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

请求参数

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

Query

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

Body

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

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

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

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

UpdateType
String
是
InputSubtitleFile

更新字幕的方式。支持的取值如下：

  • InputSubtitleFile：通过文件替换源语言字幕。如果后续流程包含语音翻译，AI 可能会调整时间戳以确保语速自然；如果您输入的新字幕文件不包含说话人 speaker 信息，AI 会基于新字幕重新执行语音识别 ASR 以生成说话人信息。
  • OutputSubtitleFile：通过文件替换目标语言字幕。如果后续流程包含语音翻译，AI 可能会调整时间戳和字幕内容以确保语速自然。
  • BilingualSubtitleFile：通过文件替换双语字幕。
  • Utterances：精确更新一条或多条字幕句段。

注意

对于 InputSubtitleFile 、 OutputSubtitleFile 和
BilingualSubtitleFile 方式，您需要先将用于替换的字幕文件以素材形式上传至 AI 翻译项目所在的点播空间，然后获取该字幕文件的 FileName。需确保字幕文件位于点播空间所关联的对象存储桶中。

InputSubtitleFileName
String
否
input_subtitle.vtt

用于替换源语言字幕的字幕文件 FileName。当 UpdateType 为 InputSubtitleFile 时必填。支持 SRT 和 VTT 格式。说话人处理逻辑：

  • 如果你提供的字幕文件中包含 <v {speaker}> 标记，系统将精确使用您指定的说话人。
  • 如果不包含 <v {speaker}> 标记，系统会基于新字幕重新进行 ASR 识别，并将识别结果与字幕文件的文本和时间轴信息结合。
OutputSubtitleFileName
String
否
output_subtitle.vtt
用于替换目标语言字幕的字幕文件 FileName。当 UpdateType 为 OutputSubtitleFile 时必填。支持 SRT 和 VTT 格式。文件中的每条字幕必须与源语言字幕在时间轴和顺序上严格对齐。说话人处理逻辑同 InputSubtitleFileName。
BilingualSubtitleFileName
String
否
dual_subtitle.vtt
用于替换双语字幕的字幕文件 FileName。当 UpdateType 为 BilingualSubtitleFile 时必填。支持 SRT 和 VTT 格式。说话人处理逻辑同 InputSubtitleFileName。
Utterances
Object[]
否
-

字幕句段列表。

注意

当 UpdateType 为 Utterances 时必传。

Id
String
是
68403b6***364cc4835c8141
句段 ID。可调用 GetAITranslationProject 接口获取，返回参数中的 SourceUtterances（源语言文本信息）和 TargetUtterances（目标语言文本信息）包含此字段。
Text
String
否
欢迎观看本视频，今天我们将介绍如何使用视频点播服务。
文本内容，支持字符长度为 1 到 500 个字节。
SpeakerId
String
否
68403b6***364cc4835c80f4
说话人 ID。可调用 GetAITranslationProject 接口获取，返回参数中的 SourceUtterances（源语言文本信息）和 TargetUtterances（目标语言文本信息）包含此字段。
Trim
Object
否
{"Start":1000,"End":2000}
用于调整字幕文本对应片段的时间间隔。调整后的时间间隔不能超过原时间间隔的两倍或小于原时间间隔的 1/2。
Start
Integer
是
1000
文本对应片段的开始时间，单位为毫秒。该值必须小于 End 字段的值。
End
Integer
是
2000
文本对应片段的结束时间，单位为毫秒。该值必须大于 Start 字段的值。
Volume
Integer
否
80
用于调整文本对应的音量大小，取值范围为 0 到 100。

返回参数

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

参数
类型
示例值
描述
ProjectBaseInfo
Object
-
项目基础信息
ProjectId
String
684038d6***c9005b266fefe
项目 ID
ProjectVersion
String
01c4fa5da***48a588a46f81e282b100
项目版本

请求示例

POST https://vod.volcengineapi.com?Action=UpdateAITranslationUtterances&Version=2025-01-01
{
  "SpaceName": "test",
  "UpdateType": "Utterances",
  "ProjectId": "684038d6b71***05b266fefe",
  "Utterances": [
    {
      "Id": "68403b6***364cc4835c8141",
      "Text": "欢迎观看本视频，今天我们将介绍如何使用视频点播服务。",
      "SpeakerId": "68403b6***364cc4835c80f4"
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "UpdateAITranslationUtterances",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectBaseInfo": {
      "ProjectId": "684038d6***c9005b266fefe",
      "ProjectVersion": "01c4fa5da***48a588a46f81e282b100"
    }
  }
}

错误码

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

SDK

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