API
Selvia AI API
Everything you can do in the console, your code can do with an API key, and so can your AI agent. Create realistic 3D avatar agents, teach them your business, put them in front of visitors, and direct them live.
What you can build
- •Live conversations. Start a session and show the player to your visitor. The avatar listens, answers from what it knows about your business, and remembers returning visitors.
- •Render mode: bring your own agent. Your speech recognition, language model and voice do the talking; you stream the speech to us and the avatar speaks it with matching lips and expressions.
- •Full setup, without the console. Agents, faces, voices, languages, studio backdrops and cameras, knowledge, data handoffs, conversations, usage and billing.
- •Live direction. Cut the camera or change the backdrop during any session.
Base URL
https://talk.selviaai.com/v1Every request and response is JSON. Authenticate with your secret key in the Authorization header, from a server, never from a web page. See Authentication & keys.
Two ways to run a session
| Conversation | Render mode | |
|---|---|---|
| Who talks | Your Selvia AI agent: its prompt, knowledge and voice | Your own agent (any speech, language-model and voice stack) |
| What you send | Nothing: the visitor talks to the avatar | Speech audio, or text we voice, over a WebSocket |
| Visitor's microphone | Yes, in the player | No: your agent hears the visitor its own way |
| Price | $0.03 per minute | $0.025 per minute |
| Start it with | "mode": "conversation" | "mode": "render" |
Start here
Quickstart →
A key, an agent and a live session in five steps.
Authentication & keys →
Secret keys, permissions, and keeping them safe.
How sessions work →
Start, show, stop: what a session is and how it ends.
Render mode →
Drive the avatar with your own voice agent.
Building with AI agents →
Hand your AI a key and the docs, and let it set things up.
All endpoints →
Every route, grouped the way the console is.
Machine-readable docs
The same documentation in the forms tools read:
- •Interactive reference: every route, with request and response shapes.
- •OpenAPI: for code generators and API clients.
- •llms.txt: the whole API in one text file for AI assistants and coding agents.