---
title: "Limites de uso"
description: "Cada limite da API do Qomni Agents (requisições por minuto, duração de sessões), seu alcance e o que acontece ao superá-lo."
version: "pt-br"
---

> 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.

# Limites de uso

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.

Source: https://docs.qomni.ai/pt-br/concepts/rate-limits/index.mdx
