添加自定义提示音

使用文本转语音生成自定义提示音。

请求 URL

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

请求参数

参数 是否必填 类型 说明
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: yeastardocs.example.yeastarcloud.com
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"
}