Shell API Docs

TTS文本转语音

POST

/v1/audio/speech

了解如何将文本转换为音频。

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{YOUR_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

number

可选

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

示例

{
    "model": "tts-1",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
  }

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/audio/speech' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "tts-1",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
  }'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
    "model": "tts-1",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
}

创建翻译

生成音乐