---
title: "Synthesize"
method: POST
path: "/v1/speech"
---

# Synthesize

`POST /v1/speech`

## Request body

- Speech — A request to generate speech in dataset. Attributes: language: the language of the text to be generated text: the text for which audio is to be generated voice: the voice to use to generate the audio model: the model to use to generate the audio format: the output format of the audio file
  - `model` 'legacy'
  - `language` 'yo' | 'en' | 'ha' | 'ig' | 'am', required
  - `text` string, required
  - `voice` 'sade' | 'segun' | 'femi' | 'funmi' | 'amina' | 'aliyu' | 'hasan' | 'zainab' | 'john' | 'jude' | 'lina' | 'lucy' | 'henry' | 'kani' | 'ngozi' | 'amara' | 'obinna' | 'ebuka' | 'hana' | 'selam' | 'tena' | 'tesfaye', required
  - `format` 'wav' | 'mp3' | 'ogg_opus' | 'webm_opus' | 'flac' | 'pcm_s16le' | 'mulaw' | 'alaw'

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-07** `62c455aac36a` — 1 breaking, 1 info
  - removed the media type `audio/wav` for the response with the status `200`
  - added the media type `audio/*` for the response with the status `200`
- **2025-10-06** `8814c306e6ef` — 1 info
  - added the new optional request property `format`
- **2025-08-05** `5e0436ccb10d` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `OAuth2PasswordBearer` was removed from the API
- **2025-08-04** `679fc54b88a0` — 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `200`
  - added the media type `audio/wav` for the response with the status `200`
- **2025-08-02** `278c2985718b` — 1 breaking, 1 info
  - removed the media type `audio/wav` for the response with the status `200`
  - added the media type `application/json` for the response with the status `200`

[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/b384c3db1a21/schema)