Core concepts
Personas
A persona is a face, a voice, a personality and a set of capabilities. Create them in Studio or through the API.
Create a persona
http
POST /v1/personas
{
"name": "Priya",
"look": "aarohi",
"system_prompt": "You are Priya, a friendly onboarding host…",
"greeting": "Hi, I'm Priya, an AI host. Welcome!",
"languages": ["en-IN", "hi-IN"],
"memory": true,
"perception": true
}Fields
| Field | Type | Description |
|---|---|---|
| name | string | Display name |
| look | string | Stock face key or custom face id |
| system_prompt | string | Personality and instructions. Keep under ~5,000 tokens |
| greeting | string | First line spoken when someone joins |
| languages | string[] | First entry is the opening language |
| memory | boolean | Remember participants across sessions |
| perception | boolean | Enable Iris perception |
| rubric | string[] | Optional scoring criteria for evaluations |
Every persona discloses it is an AI. This cannot be disabled.