Speech

Create speech

$ openai audio:speech create

post /audio/speech

Generates audio from the input text.

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

Parameters

--input: string

The text to generate audio for. The maximum length is 4096 characters.
--model: string or SpeechModel

One of the available TTS models: tts-1, tts-1-hd, gpt-4o-mini-tts, or gpt-4o-mini-tts-2025-12-15.
--voice: string or "alloy" or "ash" or "ballad" or 7 more or object { id }

The voice to use when generating the audio. Supported built-in voices are alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, marin, and cedar. You may also provide a custom voice object with an id, for example { "id": "voice_1234" }. Previews of the voices are available in the Text to speech guide.
--instructions: optional string

Control the voice of your generated audio with additional instructions. Does not work with tts-1 or tts-1-hd.
--response-format: optional "mp3" or "opus" or "aac" or 3 more

The format to audio in. Supported formats are mp3, opus, aac, flac, wav, and pcm.
--speed: optional number

The speed of the generated audio. Select a value from 0.25 to 4.0. 1.0 is the default.
--stream-format: optional "sse" or "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.

Returns

unnamed_schema_2: file path

Example

openai audio:speech create \
  --api-key 'My API Key' \
  --input input \
  --model tts-1 \
  --voice string

Domain Types

Speech Model

speech_model: "tts-1" or "tts-1-hd" or "gpt-4o-mini-tts" or "gpt-4o-mini-tts-2025-12-15"
- "tts-1"
- "tts-1-hd"
- "gpt-4o-mini-tts"
- "gpt-4o-mini-tts-2025-12-15"

cli/resources/audio/subresources/speech/index.md +69 −0 created

1# Speech

3## Create speech

5`$ openai audio:speech create`

7**post** `/audio/speech`

9Generates audio from the input text.

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

13### Parameters

15- `--input: string`

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

19- `--model: string or SpeechModel`

21 One of the available [TTS models](https://platform.openai.com/docs/models#tts): `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.

23- `--voice: string or "alloy" or "ash" or "ballad" or 7 more or object { id }`

25 The voice to use when generating the audio. Supported built-in voices are `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the voices are available in the [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).

27- `--instructions: optional string`

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

31- `--response-format: optional "mp3" or "opus" or "aac" or 3 more`

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

35- `--speed: optional number`

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

39- `--stream-format: optional "sse" or "audio"`

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

43### Returns

45- `unnamed_schema_2: file path`

47### Example

49```cli

50openai audio:speech create \

51 --api-key 'My API Key' \

52 --input input \

53 --model tts-1 \

54 --voice string

55```

57## Domain Types

59### Speech Model

61- `speech_model: "tts-1" or "tts-1-hd" or "gpt-4o-mini-tts" or "gpt-4o-mini-tts-2025-12-15"`

63 - `"tts-1"`

65 - `"tts-1-hd"`

67 - `"gpt-4o-mini-tts"`

69 - `"gpt-4o-mini-tts-2025-12-15"`