查询单个自定义提示音的信息

查询单个自定义提示音的信息。

请求 URL

GET {base_url}/{api_path}/custom_prompt/get?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
id 是 Integer 自定义提示音的 ID。
注： 可使用 搜索自定义提示音 接口查询自定义提示音的 ID。

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
prompt Object<Custom_Prompt> 自定义提示音信息。
Custom_Prompt
参数 类型 说明
id Integer 自定义提示音的 ID。
file String 自定义提示音的文件名 (无文件拓展名)。
suffix String 文件拓展名 (如 ".wav")。
type String 自定义提示音类型。
  • tts：通过文本生成语音功能生成的自定义提示音。
  • record：通过分机录制或从本地上传的自定义提示音。
storage Integer 存储设备的 ID。
real_filename String 自定义提示音的文件名，包含文件扩展名 (如 "demo.wav")。
created_ts Integer 创建自定义提示音的时间戳 (秒)。
updated_ts Integer 更新自定义提示音的时间戳 (秒)。
asr_manufacturer String 文本转语音的服务提供商。
language String 文本转语音的语言代码。
voice_id String 文本转语音的发音人。
text String 通过文本转语音生成提示音所用的文本。
speed Integer 文本转语音的语速。
volume Integer 文本转语音的音量。
pitch Integer 文本转语音的音高。
extension String 录制提示音的分机号码。
path String 提示音在存储设备上的存储路径。

Examples

请求示例

GET /openapi/v1.0/custom_prompt/get?access_token=QuIR6B6rY9PnMZGmx1B70tPW3cPHhvTl&id=55 HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "prompt": {
        "id": 55,
        "file": "BusyNow-modified-by-feature-code",
        "suffix": ".wav",
        "type": "tts",
        "storage": 1,
        "path": "/ysdisk/ysapps/pbxcenter/var/lib/asterisk/sounds/record",
        "created_ts": 1778556748,
        "updated_ts": 1788143938,
        "asr_manufacturer": "xunfei",
        "language": "zh-CN",
        "voice_id": "zh-CN_female_x4_panting",
        "text": "2222",
        "speed": 50,
        "volume": 50,
        "pitch": 50
    }
}