---
title: "Create speech (text-to-speech)"
method: POST
path: "/v1/audio/speech"
tags: ["audio"]
---

# Create speech (text-to-speech)

`POST /v1/audio/speech`

## Request body

- CoreAudioSpeechRequest
  - `input` string, required
  - `instructions` string
  - `model` string, required
  - `provider` string — Provider is gateway routing metadata, stripped before dispatching upstream.
  - `response_format` string
  - `speed` number
  - `voice` string, required

## Response `200`

Binary audio in the requested response_format

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `502` — Bad Gateway

## Changes

- **2026-08-22** `496ff50bdfef` — 4 info
  - added the optional property `error/provider` to the response with the `400` status
  - added the optional property `error/provider` to the response with the `401` status
  - added the optional property `error/provider` to the response with the `404` status
  - added the optional property `error/provider` to the response with the `502` status
- **2026-05-29** `29b33b30e62e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/v1/audio/speech/post.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/496ff50bdfef/schema)