Pular para o conteúdo
Qomni

Agents

Crie um agente, dê voz a ele e coloque-o para atender: REST para as ligações e um WebSocket para falar com ele em tempo real a partir do seu app.

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

Novidades

Navegação

Create realtime session

Open a realtime voice conversation with an agent.

Returns a WebSocket url valid for 60 seconds. The long-lived API key never travels on the socket: the session does, and its prefix (rts_{cell}_) takes it to the workspace's cell.

POST
https://api.qomni.ai/agents/v1/realtime/sessions

Autorização

  • apiKeyHTTP Bearer (sk_agents_{live|test}_{cell}_{body}{checksum})Obrigatório

Corpo da requisiçãoJSONOpcional

  • instructionsOpcionalstring

    What the agent should do in this conversation.

    maxLength: 500

Retorna

201

The session.

JSON
  • idstringObrigatório
    pattern: ^rts_[0-9a-z]+$
  • urlstringObrigatório

    Open within 60 s; speaks asyncapi.yaml.

    format: uri
  • client_secretstringObrigatório

    The session, for clients that build the URL themselves.

    pattern: ^rts_[a-z]{2}[0-9]+_
  • expires_atstringObrigatório

    Connect before this instant.

    format: date-time
  • max_duration_secondsintegerObrigatório
  • livemodebooleanObrigatório
  • cellstringObrigatório

401

Missing or invalid credentials (unauthenticated).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

403

Valid credentials that may not do this (insufficient_scope, api_key_wrong_product…).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

422

The request does not match the contract (validation_failed).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

429

Too many requests for this key (rate_limited); retry after Retry-After seconds.
JSON
  • errorobjectObrigatório
    • codestringObrigatório

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

Novo

2 de 7 passos feitosA seguir: a plataforma em produção

A Qomni está em beta privada

A API e o app ainda não estão abertos. Veja o que está feito, o que falta e como abre, passo a passo até o primeiro cliente.

Digite para buscar…

↑↓ mover↵ abrirEsc para fechar