Limites
Os limites protegem a fila de todo mundo. Valem por organização (a simultaneidade) ou por chave (a taxa), e cada um tem o seu erro.
1 min de leitura · atualizado em 13/10/2026Taxa e simultaneidade
| Limite | Valor | Ao passar |
|---|---|---|
| Pedidos REST | 120 por minuto, por chave | 429 rate_limited + Retry-After |
| Vozes ao mesmo tempo | 8 por organização (POST /v1/tts e as falas do WebSocket de voz dividem as vagas) | 429 concurrency_limited |
| WebSockets de transcrição ao vivo | 10 por organização | fechamento 4429 |
| WebSockets de avatar | 5 por organização | fechamento 4429 |
| Jobs de lote processando | 2 por organização; o resto espera na fila | — |
| Fila global de inferência | quando enche, a API pede para esperar | 503 server_busy + Retry-After |
Tamanhos
| Limite | Valor | Ao passar |
|---|---|---|
| Corpo de POST /v1/stt/transcriptions | 500 MB (mais 1 MB de formulário) | 413 payload_too_large |
| Corpo de POST /v1/tts | 128 KB | 413 payload_too_large |
| Corpo das outras rotas | 64 KB | 413 payload_too_large |
| text da voz (REST e WebSocket) | de 1 a 5.000 caracteres | 400 invalid_request / 413 payload_too_large |
| text do avatar | até 1.000 caracteres por fala | payload_too_large, sem fechar |
| Áudio do lote | até 4 horas | 413 payload_too_large |
| Fala do avatar com áudio próprio | até 5 minutos | fechamento 4413 |
| Mensagem de áudio nos WebSockets | PCM16 LE mono, até 1 s por mensagem | invalid_request |
| keyterms | até 100 termos, cada um com até 50 caracteres | 400 invalid_request |
| Upload no playground do console | 100 MB | — |
Tempos
| Limite | Valor | Ao passar |
|---|---|---|
| Sessão de WebSocket | até 4 horas | fechamento 1000 |
| Transcrição ao vivo sem áudio | 10 s encerram a sessão, com o done | — |
| Transcrição ao vivo: primeira mensagem | {"type":"start"} em até 10 s | fechamento 4400 |
| Transcrição ao vivo: adiantamento | o áudio pode chegar até 10 s à frente do relógio | fechamento 4429 |
| Voz e avatar sem mensagem | 5 minutos fecham a conexão | fechamento 1000 |
| Avatar com áudio próprio parado | 10 s sem áudio nem audio.end | fechamento 4400 |
| wait=true no lote | só para áudio de até 10 minutos; espera até 10 min | acima disso, 202 |
| Download de url no lote | 60 s e 500 MB | 400 invalid_request (413 acima de 500 MB) |
| Token temporário | de 60 s a 3.600 s (padrão 600 s) | 400 invalid_request |
| Revogação de chave | vale em até 15 s para pedidos novos; nos WebSockets, a voz e o avatar recusam a próxima fala e a transcrição ao vivo fecha em até 75 s | 401 / fechamento 4401 |
Retenção
| Limite | Valor | Ao passar |
|---|---|---|
| Áudio enviado no lote | apagado assim que o job termina | — |
| Resultado do lote | 30 dias depois de terminar; depois, 404 | 404 not_found |
| Texto e áudio da voz, do ao vivo e do avatar | nunca são gravados nem vão para o log | — |
| Webhook | até 3 tentativas: na hora, em 30 s e em 5 min | — |
Precisa de mais?
Os limites de taxa e de simultaneidade podem subir para a sua organização. Escreva para a gente com o volume esperado e o request_id de um 429 recente.