openai_speech

Available in: Cloud, Self-Managed

License: This component requires an enterprise license. You can either upgrade to an Enterprise Edition license, or generate a trial license key that's valid for 30 days.

Generates audio from a text description and other attributes, using OpenAI API.

Introduced in version 4.32.0.

# Common config fields, showing default values
label: ""
openai_speech:
  server_address: https://api.openai.com/v1
  api_key: "" # No default (required)
  model: tts-1 # No default (required)
  input: "" # No default (optional)
  voice: alloy # No default (required)
yml

This processor sends a text description and other attributes, such as a voice type and format to the OpenAI API, which generates audio. By default, the processor submits the entire payload of each message as a string, unless you use the input configuration field to customize it.

To learn more about turning text into spoken audio, see the OpenAI API documentation.

Fields

server_address

The Open API endpoint that the processor sends requests to. Update the default value to use another OpenAI compatible service.

Type: string

Default: "https://api.openai.com/v1"

api_key

The API key for OpenAI API.

This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see Secrets.

Type: string

model

The name of the OpenAI model to use.

Type: string

# Examples

model: tts-1

model: tts-1-hd
yml

input

A text description of the audio you want to generate. The input field accepts a maximum of 4096 characters.

Type: string

voice

The type of voice to use when generating the audio. This field supports interpolation functions.

Type: string

# Examples

voice: alloy

voice: echo

voice: fable

voice: onyx

voice: nova

voice: shimmer
yml

response_format

The format to generate audio in. Default is mp3. This field supports interpolation functions.

Type: string

# Examples

response_format: mp3

response_format: opus

response_format: aac

response_format: flac

response_format: wav

response_format: pcm
yml