Create Session

post

https://platform.perso.ai/api/v1/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_WEBRTC and STF_ONPREMISE cannot be used together.

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

prompt

string | null

capability

array of objects

capability

Allowed:

document

string | null

llm_type

string | null

tts_type

string | null

text_normalization_config

string | null

text_normalization_locale

string | null

stt_type

string | null

stt_text_normalization_config

string | null

stt_text_normalization_locale

string | null

model_style

string | null

agent

string | null

agent_config

string | null

padding_left

double | null

-1 to 1

padding_top

double | null

0 to 1

padding_height

double | null

0 to 5

background_image

string | null

extra_data

string

mcp_servers

array of strings

mcp_servers

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

400

Bad Request - Invalid input data or parameters.

401

Unauthorized - Invalid or missing authentication credentials.

403

Forbidden - You do not have permission to perform this action.

405

Method Not Allowed - Invalid HTTP method

406

Not Acceptable - Invalid request accept headers

415

Unsupported Media Type - Invalid content type

500

Internal Server Error - An unexpected error occurred.

201