API DOCUMENT

纯梦语音合成接口

通过纯梦 API 调用语音合成能力。用户只需要传纯梦 API Key、文本和音色 ID，平台会统一处理生成、计费和日志。

获取可用音色

请求地址

GET https://puream.cn/api/speech/voices

该接口返回纯梦平台已复刻音色列表，包含 voiceId 和试听地址。

字段	类型	说明
`voiceId`	string	语音合成时使用的音色 ID
`displayName`	string	展示名称
`category`	string	音色类型
`previewAudioUrl`	string	试听音频地址

语音合成 HTTP 接口

请求地址

POST https://puream.cn/api/ai/speech/t2a

请求 Header

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

请求参数

字段	类型	必填	示例	说明
`text`	string	是	欢迎使用纯梦语音合成	要合成的文本
`voice_setting.voice_id`	string	是	xiaomiaozhao	音色 ID，可从音色库获取
`voice_setting.speed`	number	否	1	语速
`voice_setting.vol`	number	否	1	音量
`voice_setting.pitch`	number	否	0	音调
`audio_setting.sample_rate`	number	否	32000	采样率
`audio_setting.bitrate`	number	否	128000	码率
`audio_setting.format`	string	否	mp3	音频格式

请求示例

curl -X POST "https://puream.cn/api/ai/speech/t2a" \
  -H "Authorization: Bearer 你的纯梦APIKey" \
  -H "Content-Type: application/json" \
  -d '{    "text": "欢迎使用纯梦网络语音合成模型",
    "stream": false,
    "voice_setting": {
      "voice_id": "xiaomiaozhao",
      "speed": 1,
      "vol": 1,
      "pitch": 0
    },
    "audio_setting": {
      "sample_rate": 32000,
      "bitrate": 128000,
      "format": "mp3"
    }
  }'

返回说明

成功后返回音频数据。常见音频字段包括 data.audio、audio、data.audio_file、audio_file。如果返回十六进制或 Base64 音频，可在调用端转成 mp3 播放。

WebSocket 信息接口

请求地址

GET https://puream.cn/api/ai/speech/ws

该接口用于获取语音 WebSocket 连接信息。调用时同样使用 Authorization: Bearer 你的纯梦 API Key。