文字转语音

将文字转换为语音。

POST /text-to-audio

Error

A valid request URL is required to generate request examples

200

Example

"<string>"

Authorizations

Authorization · string · header · required

API Key 认证。对于所有 API 请求，请在 Authorization HTTP 头中包含您的 API Key，并加上 Bearer 前缀。示例：Authorization: Bearer {API_KEY}。强烈建议将 API Key 存储在服务端，不要在客户端共享或存储，以避免 API Key 泄漏导致严重后果。

Body

application/json

文字转语音的请求体。提供 message_id 或 text 其中之一。

message_id · string<uuid>

消息 ID。当同时提供 text 时，优先使用消息 ID。

text · string

要转换的语音内容。

user · string

用户标识符。

voice · string

文字转语音使用的声音。可用声音取决于为此应用配置的 TTS 提供商。使用获取应用参数 → text_to_speech.voice 中的 voice 值作为默认值。

streaming · boolean

是否启用流式响应。

Response

200

audio/mpeg

返回生成的音频文件。Content-Type 头设置为音频 MIME 类型（例如 audio/wav、audio/mp3）。如果 streaming 为 true，音频将以分块传输编码方式流式返回。

The response is of type file.