Orvyn Public API
One stable API for live avatar sessions — create a session, connect the stream, end it. REST control plane, WebSocket media, generated OpenAPI reference.
The Orvyn Public API is a small, stable REST control plane plus a WebSocket media stream. Create and start a live avatar session in one call, hand a short-lived token to your frontend, stream the avatar over WebSocket, and end the session from your backend when done.
You will have a live avatar session in one API call.
Quickstart
Zero to a live session in five minutes — copy-pasteable.
API reference
The generated OpenAPI 3.1 reference — six endpoints, authoritative.
Authentication
API keys, auth headers, and short-lived WebSocket tokens.
Session lifecycle
States, ownership, and cleanup semantics.
How the platform fits together
You interact with three things:
- The REST control plane — six
/v1/endpoints for session and API-key management. Always authenticated with your API key. - The media WebSocket — a browser-facing stream that carries fMP4 video and SDK control messages. Authenticated with a short-lived token embedded in the connection URL.
- Your backend — the owner of every credential. It mints provider tokens, creates sessions, and ends them.
The rendering backend, media adapters, and provider internals are swappable implementation details. Public responses expose product concepts only — no internal endpoint names, container ids, or provider infrastructure ever appear.
The six canonical endpoints
The V0 contract is exactly these six paths — no others:
| Method | Path | Purpose |
|---|---|---|
POST |
/v1/sessions |
Create AND start a session in one call |
GET |
/v1/sessions/{session_id} |
Get session status and timings |
POST |
/v1/sessions/{session_id}/end |
End a session and release resources |
POST |
/v1/sessions/{session_id}/client-token |
Mint a fresh short-lived client token |
POST |
/v1/api-keys |
Create an API key (admin surface) |
DELETE |
/v1/api-keys/{key_id} |
Revoke an API key (admin surface) |
Every path, schema, and error code on this site is generated from the OpenAPI 3.1 specification — the API reference is authoritative. Narrative pages explain behavior; they never redefine the contract.
Where to start
- Get a live session in five minutes — the 60-second version.
- Wire up authentication — API keys + token lifecycle.
- Understand the session lifecycle — states and cleanup.
- Browse the full API reference.