Skip to main content
Send settings in the handshake’s config. Every field is optional: a field you leave out keeps its default. The reply, handshake_ack, has every setting after defaults.
A value out of range, or of the wrong type, refuses the handshake with handshake_required; message names the field. A field name Hamsa doesn’t know is ignored, so check spelling against handshake_ack. The Changes column says whether config.update can change it.

audio

The audio you send.

vad

Speech detection. See Speech detection.

stt

Speech to text. See Speech to text.

stt.turn

Turn taking. See Turns.

tts

Text to speech. voice, dialect, language and model can also be set for one request. See Text to speech. Ali exists in more than one dialect, so set voice and dialect together.

Change settings during a session

The reply is config.updated, with every setting:
  • Send only what changes; the rest stays.
  • Speech detection and turn settings apply right away. Text to speech settings apply to requests that haven’t started yet, except output and dictionary, which also apply to the request that is speaking: change those between requests.
  • Fields that can’t change (No above) are ignored, except audio, which gets an invalid_message error.
  • If any value is out of range, nothing is changed and you get an invalid_message error that names the field.