Audio

Create audio generation request

Changed on

Generate audio from input text

post/v1/audio/speech

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/audio/speech
  • Auth
    HTTP bearer

Request body

inputstring required

Input text to generate the audio for

voicestring required

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, one of the voices supported is "friendly sidekick". <br> <br> You can view the voices supported for each model using the /v1/voices endpoint sending the model name as the query parameter. View all supported voices here. <br> <br> hexgrad/Kokoro-82M additionally supports voice mixing, where two or more voices are combined into a single blended voice by joining their names with + (e.g. af_bella+af_heart). Optional per-voice weights can be provided in parentheses (e.g. af_bella(2)+af_heart(1)). Other models require a single voice name.

response_format'mp3' | 'wav' | 'raw'

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.

languagestring

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).

response_encoding'pcm_f32le' | 'pcm_s16le' | 'pcm_mulaw' | 'pcm_alaw'

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.

sample_rateinteger

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.

bit_rate32000 | 64000 | 96000 | 128000 | 192000

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.

streamboolean

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

Example request

{
  "language": "en",
  "extra_params": {
    "pronunciation_dict": [
      "omg/oh my god"
    ]
  }
}

Response

OK

Changes