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

# Generate Speech

`POST /v1/audio/speech`

## Request

- Base URL: `https://api.corent.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corent.tech/v1/audio/speech`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, nullable

## Request body

- SpeechGenerateRequest
  - `text` string, required
  - `voice_id` string, nullable
  - `model` string, nullable: Direct model access: pin an exact speech model by name, e.g. "corent-eleven-multilingual-v2". GET /v1/models publishes every name in that `corent-` spelling; older spellings of the same model (the bare name, historical route names) are still accepted here, so existing integrations keep working.
  - `stability` number, nullable: 0 to 1. Low is more expressive and more variable take to take; high is steadier.
  - `similarity` number, nullable: 0 to 1. How closely to hold the original voice's character.
  - `style` number, nullable: 0 to 1. Extra expressiveness. Costs a little latency.
  - `speed` number, nullable: Playback speed multiplier; 1.0 is natural pace.
  - `language` string, nullable: ISO language code for the multilingual models, e.g. "en" or "pt-BR".
  - `output_format` string, nullable: Delivered audio format, e.g. "mp3", "wav", or an exact "mp3_44100_128".
  - `customer_id` string, nullable: Optional tag for YOUR end user, so you can attribute spend: 1 to 128 characters from A-Z a-z 0-9 . _ : @ -. Stored on the job, returned on receipts, and filterable with GET /v1/account/usage?customer_id=...

## Response `200`

Successful Response

- SpeechGenerateResponse
  - `id` string, required
  - `status` string, required
  - `audio_url` string, required
  - `meta` SpeechMeta, required
    - `model` string, required
    - `cost_cents` integer, required
    - `duration_ms` integer, required
    - `unsupported_options` string[], nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/corent/apis/corent-api.md) · [All operations](https://skmtc.dev/corent/apis/corent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corent/apis/corent-api/revisions/57168ff53efe?raw)