Los límites protegen a cada celda de una ráfaga, tuya o de otro cliente. Son
por clave: dos claves del mismo workspace no comparten cupo. Al superar un
límite de peticiones, la API responde 429 rate_limited con un header
Retry-After que dice cuántos segundos esperar.
| Límite | Valor | Alcance | Al superarlo |
|---|---|---|---|
| Peticiones a la API | 120 por minuto | Por clave | 429 rate_limited, Retry-After |
Peticiones rechazadas con 401 |
60 por minuto | Por dirección IP | 429 rate_limited, Retry-After |
| Tiempo para abrir una sesión en tiempo real | 60 segundos desde que se crea | Por sesión | realtime_session_invalid al conectar |
| Duración de una sesión en tiempo real | 900 segundos | Por sesión | El servidor cuelga con session.ended, reason: max_duration |
Peticiones a la API
Cada clave tiene su propio presupuesto de 120 peticiones por minuto. Dos
claves detrás de la misma IP no comparten cupo. Una petición rechazada por un
4xx también cuenta.
Peticiones rechazadas con 401
Las peticiones sin clave, con una clave mal formada o con una clave de otro producto se cuentan aparte, por dirección IP, con un límite de 60 por minuto. Así un cliente mal configurado no puede agotar el presupuesto de las claves válidas que salen de la misma red.
Sesiones en tiempo real
POST /agents/v1/realtime/sessions devuelve una url que hay que abrir en
menos de 60 segundos. Una conversación dura como máximo 900 segundos: pasado
ese tiempo, el servidor envía session.ended con reason: max_duration y
cierra el socket.