Audio

Create speech

Changed on

Generates audio from the input text.

Returns the audio file content, or a stream of audio events.

post/audio/speech

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/audio/speech
  • Auth
    HTTP bearer

Request body

inputstring required

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

instructionsstring

Control the voice of your generated audio with additional instructions. Does not work with tts-1 or tts-1-hd.

response_format'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm'

The format to audio in. Supported formats are mp3, opus, aac, flac, wav, and pcm.

speednumber

The speed of the generated audio. Select a value from 0.25 to 4.0. 1.0 is the default.

stream_format'sse' | 'audio'

The format to stream the audio in. Supported formats are sse and audio. sse is not supported for tts-1 or tts-1-hd.

Example request

{
  "voice": {
    "id": "voice_1234"
  }
}

Response

OK

Changes

  • e2f8d8cbc41fRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • de263316e28bRevision changes
    • info

      added the media type audio/aac for the response with the status

    • info

      added the media type audio/flac for the response with the status

    • info

      added the media type audio/mpeg for the response with the status

    • info

      added the media type audio/opus for the response with the status

    • info

      added the media type audio/pcm for the response with the status

    • info

      added the media type audio/wav for the response with the status