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

接口说明

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

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitAudioProduceJob

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
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" }	{ "bucket": "my_bucket", "object": "target_audio" }
InputConfig	string	是	文本内容，最大支持 10000 个汉字。支持 SSML 标记语言。	test
Title	string	否	任务标题。若不提供，根据日期自动生成默认 title 长度不超过 128 字节 UTF8 编码	taskTitle
Description	string	否	任务描述：长度不超过 1024 字节 UTF8 编码	taskDescription
UserData	string	否	自定义设置，Json 格式，长度限制为 512 字节。支持自定义回调地址配置。	{"NotifyAddress":"http://xx.xx.xxx"}
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": "When it comes to Guo Degang, it can be said that he is red and purple now, and the ticket price is often very high, but he is robbed as soon as he starts. He also participates in various crosstalk variety shows to comment on the new performers."
    },
    "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\":\"When it comes to\",\"begin_time\":0,\"end_time\":846},{\"text\":\"it can be said that he is red and purple now\",\"begin_time\":846,\"end_time\":3386},{\"text\":\"and the ticket price is often very high\",\"begin_time\":3386,\"end_time\":4402},{\"text\":\"but he is robbed as soon as he starts\",\"begin_time\":4402,\"end_time\":6265},{\"text\":\"He also participates in various crosstalk variety shows to comment on the new performers.\",\"begin_time\":6265,\"end_time\":10330}]"
  }
}

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

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