You need to enable JavaScript to run this app.
视频点播

视频点播

请输入
  • 文档首页
    • 视频点播视频 AI 应用OpenAPI 参考AI 视频翻译字幕句段管理CreateAITranslationUtterance - 创建 AI 翻译项目的字幕句段
复制全文
我的收藏
字幕句段管理
CreateAITranslationUtterance - 创建 AI 翻译项目的字幕句段
复制全文
我的收藏
CreateAITranslationUtterance - 创建 AI 翻译项目的字幕句段

调用 CreateAITranslationUtterance 接口在指定的 AI 翻译项目中，新增一条字幕句段。

使用说明

该接口主要用于人工校对阶段，例如当 ASR 或 OCR 识别遗漏了某段对话时，您可以通过此接口创建一个新的句段。您需要指定新句段的起止时间和对应的说话人。创建句段后，您还需要调用 UpdateAITranslationUtterances 接口，为这个新创建的句段填充具体的文本内容。

注意事项

  • 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
  • 单个 AI 翻译项目最多支持 1000 条字幕句段。

请求说明

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

调试

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

请求参数

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

Query

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

Body

参数
类型
是否必选
示例值
描述
StartTime
Integer
是
1000

句段的起始时间戳，单位为毫秒。要求如下：

  • 必须小于或等于 EndTime。
  • 必须大于或等于 0。
  • 不能超过视频的总时长。
EndTime
Integer
是
2000

句段的结束时间戳，单位为毫秒。要求如下：

  • 必须大于或等于 StartTime。
  • 必须大于或等于 0。
  • 不能超过视频的总时长。

说明

为确保后续语音合成的质量，建议设置的句段时长（即 EndTime - StartTime）不短于 500 毫秒。

SpeakerId
String
是
68403b6***364cc4835c80f4
文本说话人 ID。用于为新创建的字幕句段指定说话人。可调用 GetAITranslationProject 接口获取，返回参数中的 SourceUtterances（源语言文本信息）和 TargetUtterances（目标语言文本信息）包含此字段。
SpaceName
String
是
test

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

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

AI 翻译项目的 ID。您可通过以下方式获取项目 ID：

返回参数

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

参数
类型
示例值
描述
SourceUtterance
Object
-
源语言句段信息
Id
String
68403b65***64cc4835c8141
句段 ID
SpeakerId
String
68403b65***64cc4835c80f4
说话人 ID
BlueprintId
String
684038d6***c9005b266feff
蓝图 ID
ClipId
String
68403b65***64cc4835c8104
片段 ID
Text
String
文本内容
文本内容
ProjectId
String
684038d6***c9005b266fefe
项目 ID
IsFacialTranslation
Boolean
false
是否为面容翻译
TranslationType
String
source

文本翻译类别，取值如下：

  • source：源语言
  • target：目标语言
Status
String
online

文本状态，取值如下：

  • online: 线上
  • need_update: 需要更新
SourceId
String
68d144a***e8202f52f29b0
源语言句段 ID。仅当 TranslationType 为 target 时生效，用于提示该目标语言句段所对应的源语言句段。
TargetUtterance
Object
-
目标语言句段信息
Id
String
68403b65***64cc4835c8141
句段 ID
SpeakerId
String
68403b65***64cc4835c80f4
说话人 ID
BlueprintId
String
684038d6***c9005b266feff
蓝图 ID
ClipId
String
68403b65***64cc4835c8104
片段 ID
Text
String
文本内容
文本内容
ProjectId
String
684038d6***c9005b266fefe
项目 ID
IsFacialTranslation
Boolean
false
是否为面容翻译
TranslationType
String
source

文本翻译类别，取值如下：

  • source：源语言
  • target：目标语言
Status
String
online

文本状态，取值如下：

  • online: 线上
  • need_update: 需要更新
SourceId
String
68d144a***e8202f52f29b0
源语言句段 ID。仅当 TranslationType 为 target 时生效，用于提示该目标语言句段所对应的源语言句段。
SourceClip
Object
-
源语言片段信息
Id
String
68403b65ef3***c4835c810b
片段 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
68403****364cc4835c80fa
轨道 ID
TargetClip
Object
-
目标语言片段信息
Id
String
68403b65ef3***c4835c810b
片段 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
68403****364cc4835c80fa
轨道 ID

请求示例 

POST https://vod.volcengineapi.com?Action=CreateAITranslationUtterance&Version=2025-01-01
{
  "StartTime": 1000,
  "EndTime": 2000,
  "SpeakerId": "68403b6***364cc4835c80f4",
  "SpaceName": "test",
  "ProjectId": "684038d6b71***05b266fefe"
}

返回示例 

{
  "ResponseMetadata": {
    "RequestId": "2025092220442***AB0A1FD6B51726A9",
    "Action": "CreateUtterance",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "SourceUtterance": {
      "Id": "68d144a9d9***202f52f29b0",
      "SpeakerId": "68beb80b***4612607066f58",
      "BlueprintId": "68beb77f2a***363c5e5ec7c",
      "ClipId": "68d144a9d***8202f52f29ae",
      "Text": "",
      "ProjectId": "68beb77f2***7363c5e5ec7b",
      "IsFacialTranslation": false,
      "TranslationType": "source",
      "Status": "online",
      "SourceId": "0000000000***00000000000"
    },
    "TargetUtterance": {
      "Id": "68d144a9d9***02f52f29b1",
      "SpeakerId": "68beb80b5c***12607066f58",
      "BlueprintId": "68beb77***37363c5e5ec7d",
      "ClipId": "68d144a9d***8202f52f29af",
      "Text": "",
      "ProjectId": "68beb77f***37363c5e5ec7b",
      "IsFacialTranslation": false,
      "TranslationType": "target",
      "Status": "need_update",
      "SourceId": "68d144a***e8202f52f29b0"
    },
    "SourceClip": {
      "Id": "68d144a9***e8202f52f29ae",
      "Trim": {
        "Start": 8580,
        "End": 9080
      },
      "Volume": 50,
      "ClipAudio": {
        "IsAudio": true,
        "Uri": "",
        "Vid": "",
        "DurationSecond": 0,
        "Url": "",
        "FileName": ""
      },
      "ClipVideo": {
        "IsAudio": false,
        "Uri": "",
        "Vid": "",
        "DurationSecond": 0,
        "Url": "",
        "FileName": ""
      },
      "FacialTranslationVideo": null,
      "TranslationType": "source",
      "TrackId": "68beb80b5***612607066f5b"
    },
    "TargetClip": {
      "Id": "68d144a9d***8202f52f29af",
      "Trim": {
        "Start": 8580,
        "End": 9080
      },
      "Volume": 50,
      "ClipAudio": {
        "IsAudio": true,
        "Uri": "",
        "Vid": "",
        "DurationSecond": 0,
        "Url": "",
        "FileName": ""
      },
      "ClipVideo": {
        "IsAudio": false,
        "Uri": "",
        "Vid": "",
        "DurationSecond": 0,
        "Url": "",
        "FileName": ""
      },
      "FacialTranslationVideo": null,
      "TranslationType": "target",
      "TrackId": "68beb80b5***612607066f5e"
    }
  }
}

错误码

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

SDK

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

最近更新时间：2025.09.23 20:31:07
这个页面对您有帮助吗？
有用
有用
无用
无用