Create Session
Create a new interactive session with the specified capabilities.
Capabilities
Choose one or more capabilities for your session. Each capability has different required fields:
| Capability | Description | Required Fields |
|---|---|---|
STF_WEBRTC | Full interactive avatar with video streaming | prompt, llm_type, model_style, tts_type |
STF_ONPREMISE | On-premise avatar rendering | model_style |
LLM | Language model conversation only | prompt, llm_type |
TTS | Text-to-speech only | tts_type |
STT | Speech-to-text only | stt_type |
Note:
STF_WEBRTCandSTF_ONPREMISEcannot be used together.
Note:
interactive_agent_configcannot be combined withllm_typeorprompt— providing either of them alongsideinteractive_agent_configis rejected with400.
Default Behavior
If no capability is specified, the session defaults to STF_WEBRTC.
Example
Select “STF_WEBRTC Session” from the Examples dropdown above to see a complete request example.
Authorizations
Body
Prompt identifier defining the system prompt + intro message. Mutually exclusive with interactive_agent_config.
1List of session capabilities to enable (e.g. STF_WEBRTC, STT, LLM).
LLM- LLMTTS- TTSSTT- STTSTF_ONPREMISE- STF_ONPREMISESTF_WEBRTC- STF_WEBRTC
LLM, TTS, STT, STF_ONPREMISE, STF_WEBRTC Optional document identifier to attach as a knowledge source.
1LLM model identifier (use List LLM Types). Mutually exclusive with interactive_agent_config.
1TTS voice/type identifier (use List TTS Types).
1Identifier of the text-normalization config applied to TTS input. Configs bundle regex rulesets that rewrite text before speech synthesis (e.g. 20℉ → 화씨 20도, ₩1,000 → 1,000 원).
1Locale code (e.g. ko-KR) used to select locale-specific rules from the configured ruleset. If omitted, only locale-agnostic rules run; if set, both locale-agnostic and matching-locale rules run.
10STT engine identifier (use List STT Types). Required only if STT capability is in capability.
1Identifier of the text-normalization config applied to STT output. Same ruleset mechanism as TTS normalization but runs on the transcribed text before it is forwarded to the LLM.
1Locale code used to select locale-specific rules from the STT normalization config. Behaviour matches text_normalization_locale.
10Model style name controlling the avatar's visual style (use List Model Styles).
1Legacy free-form agent identifier string (deprecated — prefer agent_config).
255Optional agent designer config identifier to drive a tool-using agent.
1Optional interactive-agent config identifier (pliac-*). When set, llm.request turns run on the external interactive-agent server instead of a single-shot completion. Cannot be combined with llm_type or prompt — providing either alongside is rejected.
1Horizontal avatar position offset, between -1.0 and 1.0. Negative = left, positive = right of frame center.
-1 <= x <= 1Vertical avatar position offset from the top, between 0.0 and 1.0 of the frame height.
0 <= x <= 1Avatar height scale multiplier (0-5); 1.0 = unscaled.
0 <= x <= 5Optional background image identifier for the avatar scene.
1Free-form JSON payload stored alongside the session for caller-defined metadata.
List of MCP server names available to the LLM during the session (use List MCP Types).
1Response
CREATED- CreatedEXCHANGED- ExchangedIN_PROGRESS- In ProgressTERMINATED- Terminated
CREATED, EXCHANGED, IN_PROGRESS, TERMINATED Prompt identifier defining the system prompt + intro message. Mutually exclusive with interactive_agent_config.
List of session capabilities to enable (e.g. STF_WEBRTC, STT, LLM).
LLM- LLMTTS- TTSSTT- STTSTF_ONPREMISE- STF_ONPREMISESTF_WEBRTC- STF_WEBRTC
LLM, TTS, STT, STF_ONPREMISE, STF_WEBRTC Optional document identifier to attach as a knowledge source.
LLM model identifier (use List LLM Types). Mutually exclusive with interactive_agent_config.
TTS voice/type identifier (use List TTS Types).
Identifier of the text-normalization config applied to TTS input. Configs bundle regex rulesets that rewrite text before speech synthesis (e.g. 20℉ → 화씨 20도, ₩1,000 → 1,000 원).
Locale code (e.g. ko-KR) used to select locale-specific rules from the configured ruleset. If omitted, only locale-agnostic rules run; if set, both locale-agnostic and matching-locale rules run.
10STT engine identifier (use List STT Types). Required only if STT capability is in capability.
Identifier of the text-normalization config applied to STT output. Same ruleset mechanism as TTS normalization but runs on the transcribed text before it is forwarded to the LLM.
Locale code used to select locale-specific rules from the STT normalization config. Behaviour matches text_normalization_locale.
10Model style name controlling the avatar's visual style (use List Model Styles).
Legacy free-form agent identifier string (deprecated — prefer agent_config).
255Optional agent designer config identifier to drive a tool-using agent.
Optional interactive-agent config identifier (pliac-*). When set, llm.request turns run on the external interactive-agent server instead of a single-shot completion. Cannot be combined with llm_type or prompt — providing either alongside is rejected.
Horizontal avatar position offset, between -1.0 and 1.0. Negative = left, positive = right of frame center.
-1 <= x <= 1Vertical avatar position offset from the top, between 0.0 and 1.0 of the frame height.
0 <= x <= 1Avatar height scale multiplier (0-5); 1.0 = unscaled.
0 <= x <= 5Optional background image identifier for the avatar scene.
Free-form JSON payload stored alongside the session for caller-defined metadata.
List of MCP server names available to the LLM during the session (use List MCP Types).

