API调用文档

文字转语音 TTS

POST

/v1/audio/speech

请求参数

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 | null

音频格式

可选

默认为 mp3，可选值为 mp3、opus、aac、flac、wav、pcm，用于指定音频格式。

speed

string | null

播放速度

可选

默认为 1，生成的音频播放速度。可选值为 0.25 ~ 4.0 之间。

示例

{
  "model": "tts-1",
  "input": "敏捷的棕色狐狸从懒惰的狗身上跳过去。",
  "voice": "alloy"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/audio/speech' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "tts-1",
    "input": "敏捷的棕色狐狸从懒惰的狗身上跳过去。",
    "voice": "alloy"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

// 直接返回音频文件 xxx.mp3

创建嵌入

语音转文字 whisper-1