You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/视频 AI 应用/服务端 OpenAPI/AI 视频翻译/说话人和音色管理/CreateAITranslationSpeaker - 创建 AI 语音翻译的说话人
CreateAITranslationSpeaker - 创建 AI 语音翻译的说话人
最近更新时间：2025.09.12 11:45:37首次发布时间：2025.09.12 11:45:37
复制全文
我的收藏
有用
有用
无用
无用

调用 CreateAITranslationSpeaker 创建 AI 语音翻译的说话人。

注意事项

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

请求说明

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

调试

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

请求参数

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

Query

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

Body

参数
类型
是否必选
示例值
描述
ProjectId
String
是
684038d6b71***05b266fefe

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

SpaceName
String
是
test

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

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。
SpeakerName
String
是
张三
说话人名称，长度限制为 1 到 30 个字符，且不允许重复。
Voice
String
是
zh_male_***_bigtts
音色唯一标识符。可通过 ListAITranslationSpeech 接口的返回参数获取系统预设音色或用户自建音色的唯一标识符。

返回参数

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

参数
类型
示例值
描述
ProjectBaseInfo
Object
-
项目基础信息
ProjectId
String
684038d6***c9005b266fefe
项目 ID
ProjectVersion
String
01c4fa5da***48a588a46f81e282b100
项目版本
Speaker
Object
-
说话人信息
Id
String
68403b65e***4cc4835c80f4
说话人 ID
Name
String
Speaker 1
说话人名称
Voice
String
zh_female_***_bigtts
说话人初始音色
ProjectId
String
684038d***1c9005b266fefe
项目 ID
CurrentVoice
String
zh_male_***_bigtts
说话人当前音色

请求示例

POST https://vod.volcengineapi.com?Action=CreateAITranslationSpeaker&Version=2025-01-01
{
  "ProjectId": "684038d6b71***05b266fefe",
  "SpaceName": "test",
  "SpeakerName": "张三",
  "Voice": "zh_male_***_bigtts"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "CreateAITranslationSpeaker",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectBaseInfo": {
      "ProjectId": "684038d6***c9005b266fefe",
      "ProjectVersion": "01c4fa5da***48a588a46f81e282b100"
    },
    "Speaker": {
      "Id": "68403b65e***4cc4835c80f4",
      "Name": "Speaker 1",
      "Voice": "zh_female_***_bigtts",
      "ProjectId": "684038d***1c9005b266fefe",
      "CurrentVoice": "zh_male_***_bigtts"
    }
  }
}

错误码

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

SDK

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