GET
/v1/schemas/together/audio/audio%2Fspeech
Accept:
Request body
10 properties · 3 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | enum | string | The name of the model to query.<br> <br> [See all of Together AI's chat models](https://docs.together.ai/docs/serverless-models#audio-models) The current supported tts models are: - cartesia/sonic - hexgrad/Kokoro-82M - canopylabs/orpheus-3b-0.1-ft | |
| input* | string | Input text to generate the audio for | |
| voice* | string | The voice to use for generating the audio. The voices supported are different for each model. For eg - for canopylabs/orpheus-3b-0.1-ft, one of the voices supported is tara, for hexgrad/Kokoro-82M, one of the voices supported is af_alloy and for cartesia/sonic… | |
| response_format | enum | The format of audio output. Supported formats are mp3, wav, raw if streaming is false. If streaming is true, the only supported format is raw. | mp3 | wav | raw · default: "wav" |
| language | string | Language or locale of input text. Accepts ISO 639-1 language codes (e.g., `en`, `fr`, `es`, `zh`) as well as locale codes for region-specific variants. Locale codes must be lowercase (e.g., `zh-hk` for Cantonese). | default: "en" |
| response_encoding | enum | Audio encoding of response. Only applicable when response_format is raw or pcm. Cartesia models respect this parameter and support all values. Orpheus, Kokoro, and Minimax models always return pcm_s16le regardless of this setting. | pcm_f32le | pcm_s16le | pcm_mulaw | pcm_alaw · default: "pcm_f32le" |
| sample_rate | integer | Sampling rate in Hz for the output audio. Cartesia and Minimax models respect this parameter. Orpheus and Kokoro models always output at 24000 Hz regardless of this setting. | default: 44100 |
| bit_rate | enum | Bitrate of the MP3 audio output in bits per second. Only applicable when response_format is mp3. Higher values produce better audio quality at larger file sizes. Default is 128000. Currently supported on Cartesia models. | 32000 | 64000 | 96000 | 128000 | 192000 · default: 128000 |
| stream | boolean | If true, output is streamed for several characters at a time instead of waiting for the full response. The stream terminates with `data: [DONE]`. If false, return the encoded audio as octet stream | default: false |
| extra_params | object | Additional model-specific parameters that fine-tune speech generation behavior. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"together","endpointId":"audio/speech","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}