添加自定义提示音

从存储设备中选择自定义提示音或使用文本转语音生成自定义提示音。

请求 URL

POST {base_url}/{api_path}/custom_prompt/create?access_token={access_token}

请求参数

从存储设备选择自定义提示音
参数 是否必填 类型 说明
file 是 String 自定义提示音的文件名，包含文件扩展名 (如 "demo.wav")。
type 是 String 自定义提示音类型。

取值范围：

  • specify
path 是 String 自定义提示音在存储设备上的存储路径。
注： 最大字符长度为 4096。
storage 是 Integer 存储设备的 ID。

取值范围：

  • 1：本地存储
  • 2：硬盘
  • 3: SD 卡
  • 4: USB
  • 10 or greater：网络驱动器
使用文本转语音生成自定义提示音
参数 是否必填 类型 说明
file 是 String 自定义提示音的文件名。
注：
  • 文件名不能包含文件扩展名、空格，以及特殊字符 ' " ! : @ # $ % ^ * . & ( ) { } [ ] ; / , `。
  • 最大字符长度为 250。
type 是 String 自定义提示音类型。

取值范围：

  • tts
text 是 String 用于生成自定义提示音的文本。
注：
  • 最大字符长度为 1000。
  • 文本语言必须与 language 中设置的语言相同。
language 是 String 文本转语音使用的语言的代码 (如 "en-US" 或 "zh-CN")。
注： 对应的语言必须为 asr_manufacturer 中设置的服务提供商支持的语言。
asr_manufacturer 是 String 文本转语音的服务提供商。
取值范围：
  • aws
  • xunfei
voice_id 否 String 发音人的 ID。
speed 否 Integer 语速。
注： 允许输入 1 到 100 之间的数字。
volume 否 Integer 音量。
注： 允许输入 1 到 100 之间的数字。
pitch 否 Integer 音高。
注： 允许输入 1 到 100 之间的数字。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。

示例

请求示例

POST /openapi/v1.0/custom_prompt/create?access_token=gwakjgu9ZBUfz36wql4ndsVKkryI0kdj HTTP/1.1
Host: 192.168.5.150:8088
Content-Type: application/json
{
  "file": "doc_demo_tts",
  "type": "tts",
  "text": "Welcome to the system.",
  "language": "en-US",
  "asr_manufacturer": "aws",
  "voice_id": "en-US_female_ne_danielle",
  "speed": 50,
  "volume": 50,
  "storage": 1
}

响应示例

HTTP/1.1 200 OK
{
  "errcode": 0,
  "errmsg": "SUCCESS"
}