---
title: "Generate audio"
method: POST
path: "/v1/speech"
---

# Generate audio

`POST /v1/speech`

## Headers

- `X-Data-Retention` boolean

## Request body

- SpeechRequest
  - `language` string — This is optional; an ISO 639 language code to be used for the generation.
  - `text` string, required — The text for which you want to generate audio.
  - `voice` 'sade' | 'segun' | 'femi' | 'funmi' | 'amina' | 'aliyu' | 'hasan' | 'zainab' | 'john' | 'jude' | 'lina' | 'lucy' | 'henry' | 'kani' | 'remi' | 'kingsley' | 'ngozi' | 'amara' | 'obinna' | 'ebuka' | 'hana' | 'haile' | 'tena' | 'tesfaye' | 'ufoma' | 'tega' | 'justice' | 'boma', required
  - `speed` number, float — The speed of the voice, defaults to `1.0`
  - `format` 'mp3' | 'wav' | 'ogg_opus' | 'webm_opus' | 'mulaw' | 'alaw' | 'flac' | 'pcm_s16le'

## Response `200`

Successful Response

## Changes

- **2026-04-30** `345ddd9a88d1` — 7 breaking, 1 warning, 10 info
  - removed the enum value `am` of the request property `language`
  - removed the enum value `en` of the request property `language`
  - removed the enum value `ha` of the request property `language`
  - removed the enum value `ig` of the request property `language`
  - …14 more
- **2026-01-22** `d909291d8029` — 1 warning, 1 info
  - deleted the `header` request parameter `Spitch-X-Data-Retention`
  - added the new optional `header` request parameter `X-Data-Retention`
- **2026-01-22** `a561cc9455e2` — 1 breaking
  - for the `header` request parameter `Spitch-X-Data-Retention`, default value `true` was added
- **2026-01-21** `bb7bdab564b8` — 1 info
  - added the new optional request property `format`
- **2026-01-21** `9caec45089fb` — 2 breaking, 1 warning, 8 info
  - removed `#/components/schemas/TTSModelEnum` from the `model` request property `anyOf` list
  - removed the media type `audio/*` for the response with the status `200`
  - removed the request property `format`
  - api operation id `synthesize_v1_speech_post` removed and replaced with `generateAudio`
  - …7 more

[Full history](https://skmtc.dev/spi-tch/apis/spitch-api/changes/v1/speech/post.md)

---

[API](https://skmtc.dev/spi-tch/apis/spitch-api.md) · [All operations](https://skmtc.dev/spi-tch/apis/spitch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spi-tch/spitch-api/revisions/345ddd9a88d1/schema)