编辑群语音信箱问候语

编辑群语音信箱问候语。

请求 URL

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

请求参数

编辑录制的或上传的问候语
参数 是否必填 类型 说明
id 是 Integer 问候语的 ID。
注: 可使用 查询群语音信箱问候语列表 接口查询问候语的 ID。
number 是 String 问候语所属的群语音信箱号码。
file 是 String 问候语文件名。
注:
  • 文件名不能包含文件扩展名、空格,以及特殊字符 ' " ! : @ # $ % ^ * . & ( ) { } [ ] ; / , `。
  • 最大字符长度为 250。
编辑通过文本转语音生成的问候语
注: 如果文本转语音相关字段被修改,如语言、发音人、文本、语速等,则重新生成音频,支持异步回调。
参数 是否必填 类型 说明
id 是 Integer 问候语的 ID。
注: 可使用 查询群语音信箱问候语列表 接口查询问候语的 ID。
number 是 String 问候语所属的群语音信箱号码。
file 否 String 问候语文件名。
注:
  • 文件名不能包含文件扩展名、空格,以及特殊字符 ' " ! : @ # $ % ^ * . & ( ) { } [ ] ; / , `。
  • 最大字符长度为 250。
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:请求失败。

示例

请求示例

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

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
{
  "id": 6,
  "file": "doc_demo_vmg_v2"
}

响应示例

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