Saltar al contenido
Qomni

Agents

Crea un agente, dale voz y ponlo a atender: REST para las llamadas y un WebSocket para hablar con él en tiempo real desde tu app.

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

Novedades

Navegación

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

Autorización

  • apiKeyHTTP Bearer (sk_agents_{live|test}_{cell}_{body}{checksum})Obligatorio

Cuerpo de la peticiónJSONOpcional

  • instructionsOpcionalstring

    What the agent should do in this conversation.

    maxLength: 500

Devuelve

201

The session.

JSON
  • idstringObligatorio
    pattern: ^rts_[0-9a-z]+$
  • urlstringObligatorio

    Open within 60 s; speaks asyncapi.yaml.

    format: uri
  • client_secretstringObligatorio

    The session, for clients that build the URL themselves.

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

    Connect before this instant.

    format: date-time
  • max_duration_secondsintegerObligatorio
  • livemodebooleanObligatorio
  • cellstringObligatorio

401

Missing or invalid credentials (unauthenticated).
JSON
  • errorobjectObligatorio
    • codestringObligatorio

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

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

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

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

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

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

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

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

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

Nuevo

2 de 7 pasos hechosSigue: la plataforma en producción

Qomni está en beta privada

La API y la app todavía no están abiertas. Mira qué está hecho, qué falta y cómo se abre, paso a paso hasta el primer cliente.

Escribe para buscar…

↑↓ moverte↵ abrirEsc para cerrar