---
title: "Generate Tts Audio"
method: POST
path: "/v1/tts/generate"
tags: ["TTS"]
---

# Generate Tts Audio

`POST /v1/tts/generate`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/tts/generate`
- Auth: HTTP bearer

Generate an audio message from text using the configured TTS provider.

If voice_id is provided, uses the org's cloned voice.
Returns a presigned S3 URL for immediate playback and the S3 key.

## Request body

- TTSGenerateRequest
  - `text` string, required
  - `tone` 'professional' | 'friendly' | 'enthusiastic'
  - `voice_id` string, nullable
  - `optimize_text` boolean
  - `background_noise` string, nullable
  - `language_code` string, nullable

## Response `200`

Successful Response

- TTSGenerateResponse
  - `audio_url` string, required
  - `s3_key` string, required
  - `spoken_text` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orsay/apis/orsay-api.md) - [All operations](https://skmtc.dev/orsay/apis/orsay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orsay/apis/orsay-api/revisions/988a26cafef5?raw)