---
title: "Create Speech"
method: POST
path: "/v1/audio/speech"
tags: ["v1", "audio"]
---

# Create Speech

`POST /v1/audio/speech`

Generate speech audio from text.

Generates audio from the input text using text-to-speech models. Supports multiple
voices and output formats including mp3, opus, aac, flac, wav, and pcm.

Returns streaming audio data that can be saved to a file or streamed directly to users.

## Request body

- CreateSpeechRequest — Request to generate audio from text.
  - `model` string, required — One of the available [TTS models](https://platform.openai.com/docs/models#tts): `openai/tts-1`, `openai/tts-1-hd` or `openai/gpt-4o-mini-tts`.
  - `input` string, required — The text to generate audio for. The maximum length is 4096 characters.
  - `voice` 'alloy' | 'ash' | 'ballad' | 'coral' | 'echo' | 'fable' | 'onyx' | 'nova' | 'sage' | 'shimmer' | 'verse', required — The voice to use when generating the audio. Supported voices are `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and `verse`. Previews of the voices are available in the [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
  - `instructions` string, nullable — 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', nullable — The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`, `wav`, and `pcm`.
  - `speed` number, nullable — The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is the default.
  - `stream_format` 'sse' | 'audio', nullable — The format to stream the audio in. Supported formats are `sse` and `audio`. `sse` is not supported for `tts-1` or `tts-1-hd`.

## Response `200`

Audio file stream

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/dedalus-labs/apis/dedalus-api.md) · [All operations](https://skmtc.net/dedalus-labs/apis/dedalus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dedalus-labs/dedalus-api/versions/81ffcde15f4c/schema)