添加群语音信箱问候语

通过文本转语音生成群语音信箱问候语。音频异步生成，结果通过 WebSocket 回调返回。

请求 URL

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

请求参数


参数	是否必填	类型	说明
file	是	String	问候语文件名。注：文件名不能包含文件扩展名、空格，以及特殊字符 `'` `"` `!` `:` `@` `#` `$` `%` `^` `*` `.` `&` `(` `)` `{` `}` `[` `]` `;` `/` `,` `。最大字符长度为 250。
type	是	String	问候语类型。取值范围： `tts`
number	是	String	问候语所属的群语音信箱号码。
text	是	String	用于生成问候语的文本。注：最大字符长度为 1000。文本语言必须与 `language` 中设置的语言相同。
language	是	String	文本转语音使用的语言的代码 (如 "en-US" 或 "zh-CN")。注：对应的语言必须为 `asr_manufacturer` 中设置的服务提供商支持的语言。
asr_manufacturer	是	String	文本转语音的服务提供商。取值范围： `aws` `azure` `xunfei`
voice_id	否	String	发音人的 ID。
speed	否	Integer	语速。注：允许输入 1 到 100 之间的数字。
volume	否	Integer	音量。注：允许输入 1 到 100 之间的数字。
pitch	否	Integer	音高。注：允许输入 1 到 100 之间的数字。

响应参数


参数	类型	说明
errcode	Integer	返回错误码。 `0`：请求成功。非零值：请求失败。注：更多错误码和错误信息说明，请参见错误码 & 错误信息。
errmsg	String	返回信息。 `SUCCESS`：请求成功。 `FAILURE`：请求失败。
id	Integer	新建的语音信箱问候语的 ID。
status	String	文本转语音的生成状态。 `pending`：音频正在异步生成。 `complete`：音频生成完毕。
request_id	String	文本转语音异步任务的客户端请求 ID，可用于匹配 WebSocket 回调通知。

示例

请求示例

POST /openapi/v1.0/vm_greeting/create?access_token=gwakjgu9ZBUfz36wql4ndsVKkryI0kdj HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
{
  "file": "doc_demo_vm",
  "type": "tts",
  "number": "6100",
  "text": "Thank you for calling. Please leave a message.",
  "language": "en-US",
  "asr_manufacturer": "aws",
  "voice_id": "en-US_female_ne_danielle",
  "speed": 50,
  "volume": 50
}

响应示例

HTTP/1.1 200 OK
{
  "errcode": 0,
  "errmsg": "SUCCESS",
  "id": 0,
  "status": "pending",
  "request_id": ""
}