Os limites protegem cada célula de uma rajada, sua ou de outro cliente. Eles são
por chave: duas chaves do mesmo workspace não compartilham cota. Ao superar um
limite de requisições, a API responde 429 rate_limited com um header
Retry-After que diz quantos segundos esperar.
| Limite | Valor | Alcance | Ao superá-lo |
|---|---|---|---|
| Requisições à API | 120 por minuto | Por chave | 429 rate_limited, Retry-After |
Requisições rejeitadas com 401 |
60 por minuto | Por endereço IP | 429 rate_limited, Retry-After |
| Tempo para abrir uma sessão em tempo real | 60 segundos desde a criação | Por sessão | realtime_session_invalid ao conectar |
| Duração de uma sessão em tempo real | 900 segundos | Por sessão | O servidor desliga com session.ended, reason: max_duration |
Requisições à API
Cada chave tem seu próprio orçamento de 120 requisições por minuto. Duas
chaves atrás do mesmo IP não compartilham cota. Uma requisição rejeitada por um
4xx também conta.
Requisições rejeitadas com 401
As requisições sem chave, com uma chave mal formada ou com uma chave de outro produto são contadas à parte, por endereço IP, com um limite de 60 por minuto. Assim um cliente mal configurado não consegue esgotar o orçamento das chaves válidas que saem da mesma rede.
Sessões em tempo real
POST /agents/v1/realtime/sessions devolve uma url que precisa ser aberta em
menos de 60 segundos. Uma conversa dura no máximo 900 segundos: passado
esse tempo, o servidor envia session.ended com reason: max_duration e
fecha o socket.