API · Set up agents

Faces, voices & backdrops

What an agent can look and sound like. Faces come with a description in words and stills, so an AI choosing for you can pick one without browsing a gallery.

Faces

GET/v1/catalog/faces

Public: no key needed. Use the id as an agent's avatar_id, or for one session.

Response

{
  "faces": [
    {
      "id": "face09",
      "gender": "female",
      "description": "Woman, 30s, light olive skin, shoulder-length dark wavy hair, coral top.",
      "still_url": "https://talk.selviaai.com/api/public/embed-poster/face09.webp?v=…",
      "camera_stills": { "far": "https://…", "mid": "https://…", "close": "https://…" }
    }
  ]
}
face01: Woman, late 20s to 30s, light skin, blonde chin-length bob, navy top.
face01 in the far cameraface01 in the mid cameraface01 in the close camera
face01 · female

Woman, late 20s to 30s, light skin, blonde chin-length bob, navy top.

face02: Man, 30s, light skin, short swept-back blond hair, athletic build, charcoal top.
face02 in the far cameraface02 in the mid cameraface02 in the close camera
face02 · male

Man, 30s, light skin, short swept-back blond hair, athletic build, charcoal top.

face03: Woman, 20s to 30s, light skin, short brown pixie cut, burgundy top.
face03 in the far cameraface03 in the mid cameraface03 in the close camera
face03 · female

Woman, 20s to 30s, light skin, short brown pixie cut, burgundy top.

face04: Man, 50s to 60s, light skin, full head of grey hair, light blue top.
face04 in the far cameraface04 in the mid cameraface04 in the close camera
face04 · male

Man, 50s to 60s, light skin, full head of grey hair, light blue top.

face05: Woman, 20s to 30s, medium brown skin, dark hair pulled back, mustard yellow top.
face05 in the far cameraface05 in the mid cameraface05 in the close camera
face05 · female

Woman, 20s to 30s, medium brown skin, dark hair pulled back, mustard yellow top.

face06: Man, 20s to 30s, brown skin, short dark hair, pale green top.
face06 in the far cameraface06 in the mid cameraface06 in the close camera
face06 · male

Man, 20s to 30s, brown skin, short dark hair, pale green top.

face07: Woman, 20s to 30s, dark skin, short natural curly black hair, teal top.
face07 in the far cameraface07 in the mid cameraface07 in the close camera
face07 · female

Woman, 20s to 30s, dark skin, short natural curly black hair, teal top.

face08: Man, 30s, dark skin, short black hair, cream top.
face08 in the far cameraface08 in the mid cameraface08 in the close camera
face08 · male

Man, 30s, dark skin, short black hair, cream top.

face09: Woman, 30s, light olive skin, shoulder-length dark wavy hair, coral top.
face09 in the far cameraface09 in the mid cameraface09 in the close camera
face09 · female

Woman, 30s, light olive skin, shoulder-length dark wavy hair, coral top.

face10: Man, 20s to 30s, light tan skin, short dark hair, broad shoulders, light blue top.
face10 in the far cameraface10 in the mid cameraface10 in the close camera
face10 · male

Man, 20s to 30s, light tan skin, short dark hair, broad shoulders, light blue top.

face11: Woman, 30s, light olive skin, shoulder-length straight dark hair, purple top.
face11 in the far cameraface11 in the mid cameraface11 in the close camera
face11 · female

Woman, 30s, light olive skin, shoulder-length straight dark hair, purple top.

face12: Woman, 20s, light skin, straight black chin-length bob with a centre parting, dusty pink top.
face12 in the far cameraface12 in the mid cameraface12 in the close camera
face12 · female

Woman, 20s, light skin, straight black chin-length bob with a centre parting, dusty pink top.

face13: Woman, 20s to 30s, light olive skin, dark hair pulled back, green top.
face13 in the far cameraface13 in the mid cameraface13 in the close camera
face13 · female

Woman, 20s to 30s, light olive skin, dark hair pulled back, green top.

face14: Man, 20s, light skin, short black hair with a fringe, light grey top.
face14 in the far cameraface14 in the mid cameraface14 in the close camera
face14 · male

Man, 20s, light skin, short black hair with a fringe, light grey top.

The three small stills are the face in the far, mid and close cameras. New faces are added over time; read the list from the API rather than copying ids into your code.

Backdrops

GET/v1/catalog/backdrops

Public. Use the id in an agent's studio.backdrop, a session's look, or a live stage change. null (or none on a live stage) is plain: each face's own wall.

Lounge backdrop
lounge Lounge
Library backdrop
library Library
Café backdrop
cafe Café
Salon backdrop
salon Salon
Office backdrop
office Office
Bright office backdrop
brightoffice Bright office

Cameras

GET/v1/catalog/cameras
idFraming
farChest up
midShoulders and face
closeFace, top of the hair and neck

During a conversation far and mid take turns and close is kept for strong sentences. An agent's studio.cameras chooses which ones it uses; a live session can also hold one.

Voices

GET/v1/voices/{provider}?language=&gender=

The voices of one provider, optionally for one language (en, es, …) and gender (f or m). Needs a key with read. Providers: kokoro (free), and the premium inworld, inworld-flash, elevenlabs, elevenlabs-flash and cartesia.

curl "https://talk.selviaai.com/v1/voices/kokoro?language=es&gender=f" \
  -H "Authorization: Bearer $SELVIA_API_KEY"

Hear one

GET/v1/voices/{provider}/{voice_id}/preview

A short audio sample of the voice.