ChatPlus API

文字转换语音

POST

/v1/audio/speech

将文本转换为音频。

支持的模型：tts-1、tts-1-1106、tts-1-hd、tts-1-hd-1106

请求参数

Header 参数

Content-Type

string

必需

在HTTP的请求Header中添加参数Content-Type POST请求主体类型为application/json

示例值:

application/json

Authorization

string

必需

在HTTP的请求Header中添加参数Authorization，其值为在Bearer之后拼接以sk-开头的令牌API KEY的值。

示例值:

Bearer {{API_KEY}}

Body 参数application/json

model

string

必需

可用的 TTS 模型之一：tts-1 或 tts-1-hd

input

string

必需

要生成音频的文本。最大长度为4096个字符。

voice

string

必需

生成音频时使用的语音。支持的语音有:alloy、echo、fable、onyx、nova 和 shimmer。

response_format

string

可选

默认为 mp3 音频的格式。支持的格式有:mp3、opus、aac 和 flac。

speed

string

可选

默认为 1 生成的音频速度。选择0.25到4.0之间的值。1.0是默认值。

示例

{
  "model": "tts-1",
  "input": "你好，喜欢我的声音吗？",
  "voice": "alloy"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://chatplusapi.cn/v1/audio/speech' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "tts-1",
  "input": "你好，喜欢我的声音吗？",
  "voice": "alloy"
}'

返回响应

🟢200成功

application/octet-stream

Body

object {0}

示例

成功返回转换后语音MP3的二进制文件内容，使用python requests请求后保存文件代码如下：
# file_path为要保存的文件路径，response.content为二进制文件内容

with open(file_path, 'wb') as file:
    file.write(response.content)

🟠403失败

文字对话聊天

语音转换文字