OpenAI API

Create speech

POST

https://api.openai.com/v1/audio/speech

Creates a model response for the given chat conversation. Learn more in the text generation, vision, and audio guides.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

required

Example:

Bearer $OPENAI_API_KEY

Content-Type

string

required

Example:

application/json

Body Params application/json

model

string

required

One of the available TTS models: tts-1 or tts-1-hd

input

string

required

The text to generate audio for. The maximum length is 4096 characters.

voice

string

required

The voice to use when generating the audio. Supported voices are alloy, echo, fable, onyx, nova, and shimmer. Previews of the voices are available in the Text to speech guide.

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200Success

application/json

The audio file content.

Body

object {0}

Example

{}

Modified at 2024-12-13 10:20:37

Create translation

Create batch