---
title: "Bienvenida"
description: "Qué es Qomni Agents, qué hace su API y qué reglas comparte cada endpoint, para que elijas por dónde empezar."
version: "es"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bienvenida

Qomni es Agents: agentes de IA que contestan el teléfono, llaman a tus
clientes y conversan en tiempo real desde tu app. Tiene una app web para
administrarlos y una API para ponerlos en tu código. Toda la API sigue las
mismas reglas: las mismas claves, los mismos errores y el mismo modo de
prueba. Si aprendes un endpoint, sabes usar todos.

## Qué hace la API

| Recurso | Qué haces con él | Dónde |
|---|---|---|
| Llamadas | Un agente llama a un número y te dice cómo terminó | `POST /calls`, `GET /calls` |
| Sesiones en tiempo real | Tu app abre una conversación de voz o texto con un agente, sin exponer tu clave | `POST /realtime/sessions` y un WebSocket |
| Contexto de la clave | Comprueba una clave y mira en qué celda vive tu workspace | `GET /ping` |

La API vive en un solo host, `api.qomni.ai`: la ruta empieza por el producto
y después la versión, `https://api.qomni.ai/agents/v1`. Habla JSON y se
versiona en la ruta. Dentro de una versión sólo se agregan campos, nunca se
quitan: tu cliente debe ignorar los campos que no conoce.

## Lo que vale en todos los endpoints

- **Una clave por modo.** `sk_agents_test_…` para probar,
  `sk_agents_live_…` para producción. Ver [API keys y autenticación](/es/concepts/authentication/).
- **Un solo host.** Tu código no elige región: la clave lleva la celda y el
  edge enruta. Ver [El edge y las celdas](/es/concepts/edge/).
- **La misma forma de error.** `code` para tu código, `message` para
  personas, `request_id` para soporte. Ver [Errores](/es/concepts/errors/).
- **Modo de prueba sin consecuencias.** La misma API, sin marcar ni
  facturar nada. Ver [Modo de prueba](/es/concepts/test-mode/).

## Por dónde empezar

- [Inicio rápido](/es/get-started/quickstart/) — Comprueba una clave y haz que un agente llame a un número, en cinco minutos.
- [Habla con un agente en tiempo real](/es/agents/realtime/) — Crea una sesión, abre el socket y conversa desde tu app.
- [Conceptos](/es/concepts/) — Las reglas que valen para toda la API.
- [Referencia de la API](/es/agents-api/) — Cada endpoint, campo y error, generado desde el contrato.

Source: https://docs.qomni.ai/es/get-started/index.mdx
