调用SubmitAudioProduceJob接口实现文本转语音-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

接口说明

该接口为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果将通过回调通知，也可通过获取智能任务结果主动查询任务状态。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitAudioProduceJob

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
EditingConfig	string	是	音频生产配置： voice 声音类型 customizedVoice 人声克隆的 VoiceId format 输出文件格式，支持：PCM/WAV/MP3 volume 音量，取值 0~100，默认值 50 speech_rate 语速，取值范围：-500～500，默认值：0 [-500, 0, 500] 对应的语速倍速区间为 [0.5, 1.0, 2.0] 计算方法如下： 0.8 倍速（1-1/0.8）/0.002 = -125 1.2 倍速（1-1/1.2）/0.001 = 166 小于 1 倍速时，使用 0.002 系数大于 1 倍速时，使用 0.001 系数 pitch_rate 语调，取值范围：-500～500，默认值：0 重要如果同时传入 voice 和 customizedVoice 会优先使用 customizedVoice。	{"voice":"Siqi","format":"MP3","volume":50}
OutputConfig	string	是	音频输出配置	例如将输出的语音存至：http://my_bucket.oss-cn-shanghai.aliyuncs.com/target_audio.mp3，则此参数配置为： { "bucket": "my_bucket", "object": "target_audio" }
InputConfig	string	是	文本内容，最大支持 10000 个汉字。支持 SSML 标记语言。	测试文本
Title	string	否	任务标题。若不提供，根据日期自动生成默认 title 长度不超过 128 字节 UTF8 编码	任务标题。若不提供，根据日期自动生成默认title 长度不超过128字节 UTF8编码
Description	string	否	任务描述：长度不超过 1024 字节 UTF8 编码	任务描述长度不超过1024字节 UTF8编码
UserData	string	否	自定义设置，Json 格式，长度限制为 512 字节。支持自定义回调地址配置。	{"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}
Overwrite	boolean	否	是否覆盖现有 OSS 文件。	true

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID	****11-DB8D-4A9A-875B-275798****
JobId	string	任务 ID	**20b48fb04483915d4f2cd8ac**
State	string	任务状态： Created Executing Finished Failed	Created
MediaId	string	媒资 Id	**2bcbfcfa30fccb36f72dca22**

智能语音任务执行结果可以用智能语音任务 JobId 通过获取智能任务结果接口查询任务执行详细信息，任务执行成功时获取智能任务结果接口返回结果示例如下。

说明

AI_TTS 默认根据中文逗号、句号等标点符号进行断句

{
  "RequestId": "******2D-443C-5043-B0E4-867070******",
  "JobId": "******042d5e4db6866f6289d1******",
  "State": "Finished",
  "SmartJobInfo": {
    "Title": "default_title_2022-01-21T06:15:07Z",
    "JobType": "TextToSpeech",
    "CreateTime": "2022-01-21T06:15:07Z",
    "ModifiedTime": "2022-01-21T06:15:07Z",
    "InputConfig": {
      "InputFile": "提起郭德纲，现在可以说是红的发紫了，常常票价很高，但是一开手就被疯抢一空，还参加各种相声综艺节目点评新人表演演员已经"
    },
    "EditingConfig": "{\"format\":\"MP3\",\"pitch_rate\":0,\"sample_rate\":16000,\"speech_rate\":0,\"voice\":\"Siqi\",\"volume\":50}",
    "OutputConfig": {
      "Bucket": "your-bucket",
      "Object": "your-audio"
    }
  },
  "JobResult": {
    "MediaId": "******bf47c94e82b3b2014361******",
    "AiResult": "[{\"text\":\"提起\",\"begin_time\":0,\"end_time\":846},{\"text\":\"现在可以说是红的发紫了\",\"begin_time\":846,\"end_time\":3386},{\"text\":\"常常票价很高\",\"begin_time\":3386,\"end_time\":4402},{\"text\":\"但是一开手就被疯抢一空\",\"begin_time\":4402,\"end_time\":6265},{\"text\":\"还参加各种相声综艺节目点评新人表演演员已经\",\"begin_time\":6265,\"end_time\":10330}]"
  }
}

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "State": "Created",
  "MediaId": "****2bcbfcfa30fccb36f72dca22****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。