This endpoint is used to initiate a new streaming session.

This endpoint is used to initiate a new streaming session with an Interactive Avatar. It sets up a fresh session, allowing for real-time interactions and communication.

Request Body

FieldTypeDescription
qualitystringThe quality of the data to be retrieved. Can be "high", "medium", or "low".
avatar_idstring (optional)The ID of the Interactive Avatar to use. If not provided, a default avatar will be chosen. Default: default
voice_name(deprecated)string (optional)The Voice ID for the Interactive Avatar. Default: en-US-JennyNeural
voiceVoiceSetting(optional)The settings for the Interactive Avatar's voice.

VoiceSetting

FieldTypeDescription
voice_idstring (optional)Voice for your Interactive Avatar. See the available voices by calling the List Voices endpoint. Note: Not every voice is supported in the streaming API.
ratefloat(optional)Voice speed rate. Default is 1.
emotionstring (optional)Emotion to use for Emotional voices. Available emotions are Excited, Serious, Friendly, Soothing, Broadcaster

Response Body

FieldTypeDescription
codeintegerThe response status code.
messagestringThe response message.
dataobjectContains the response data.
data.ice_servers(deprecated)string arrayUse ice_servers2 instead.
data.ice_servers2ICEServer arrayA list of ICE servers.
data.sdpobjectThe Session Description Protocol (SDP) data.
data.session_idstringThe session ID.

ICEServer

FieldTypeDescription
urlsstring arrayThe list of ICE server URLs, including STUN and TURN servers.
usernamestringThe username for authentication.
credentialstringThe credential for authentication.

SDP

FieldTypeDescription
sdpstringThe Session Description Protocol (SDP) data.
typestringThe type of SDP, which is "offer".
Language
Authorization
Header
Click Try It! to start a request and see the response here!