Service options are service configuration settings that are applied at initialization time. These settings are items that are traditionally not changed throughout the session. For example, the model an LLM service, the language of an STT service, or the sample_rate of a TTS service.

Refer to the individual service pages to learn more about the available service options.

The service_options are specified in the payload to the /bots/start endpoint in the following format:

{
  "service_options": {
    "<service name>": {
      "<option name>": "<option value>"
    },
    "<service name>": {
      "<option1 name>": "<option1 value>",
      "<option2 name>": "<option2 value>"
    }
  }
}

For example, if you’re setting the sample_rate for the TTS service and a base_url for an LLM, you would set it like this:

{
  "service_options": {
    "openai_tts": {
      "sample_rate": 24000
    },
    "sambanova": {
      "base_url": "https://api.sambanova.ai"
    }
  }
}