Skip to content
Qomni

Agents

Create an agent, give it a voice and put it to work: REST for the calls and a WebSocket to talk to it in real time from your app.

Base URL
https://api.qomni.ai/agents/v1
Key
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

What's new

Navigation

Create demo session

Start a voice conversation with Qomni's demo agent from the public website, without a key. The answer is a LiveKit participant token for a new room in the demo workspace's cell, with the demo agent already dispatched into it: join url with token within 60 seconds, publish the microphone and play the agent's audio. The call is in test mode and ends by itself after max_duration_seconds, or after 20 seconds without the visitor speaking.

Limits: 3 sessions per IP in 10 minutes and 10 in 24 hours (rate_limited), and a daily cap of demo minutes for everyone (demo_unavailable). CORS answers only the website's origin. An API key sent anyway is ignored.

POST
https://api.qomni.ai/agents/v1/demo_sessions

Request bodyJSONOptional

  • languageOptionalesorenorpt-br

    The language the demo agent speaks.

    default: "en"
  • agentOptionalreceptionorschedulingorqualificationorsupportorcollectionsorreminders

    Which demo agent answers - a receptionist, appointment booking, lead qualification, first-level support, collections or appointment reminders.

    default: "reception"

Returns

201

The demo session.

JSON
  • urlstringRequired

    The cell's LiveKit (wss://…).

    format: uri
  • tokenstringRequired

    A LiveKit participant token for room only, microphone only.

  • roomstringRequired
    pattern: ^demo-[0-9a-z]+$
  • expires_atstringRequired

    Join before this instant.

    format: date-time
  • max_duration_secondsintegerRequired

    The call ends by itself after this long.

422

The request does not match the contract (validation_failed).
JSON
  • errorobjectRequired
    • codestringRequired

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringRequired

      For people; may change at any time.

    • request_idOptionalstring
    • fieldsOptionalmap ofarray<string>

      Only for validation_failed, the messages per field.

429

Too many demo sessions from this address (rate_limited); retry after Retry-After seconds.
JSON
  • errorobjectRequired
    • codestringRequired

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringRequired

      For people; may change at any time.

    • request_idOptionalstring
    • fieldsOptionalmap ofarray<string>

      Only for validation_failed, the messages per field.

503

The demo has used today's minutes (demo_unavailable), or is not offered in this environment.
JSON
  • errorobjectRequired
    • codestringRequired

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringRequired

      For people; may change at any time.

    • request_idOptionalstring
    • fieldsOptionalmap ofarray<string>

      Only for validation_failed, the messages per field.

New

2 of 7 steps doneNext: the platform in production

Qomni is in private beta

The API and the app are not open yet. See what is done, what is left and how it opens, step by step until the first customer.

Type to search…

↑↓ move↵ openEsc to close