Limites e erros
Limites por conta e o que fazer com cada código de erro.
Todo erro vem no mesmo formato:
{ "error": { "code": "insufficient_balance", "message": "Saldo insuficiente: faltam R$ 1,20.", "request_id": "req_9f2k" } }Guarde o request_id: com ele o suporte encontra a chamada.
Limites
| Limite | Grátis | Com recarga ou assinatura | Escritório |
|---|---|---|---|
| Pedidos por minuto | 60 | 600 | 1.200 |
| Transcrições ao mesmo tempo | 2 | 10 | 30 |
| Chaves de API | 2 | 10 | 50 |
Por arquivo: até 4 horas e 1 GB. Formatos: MP3, WAV, M4A/AAC, OGG/Opus, FLAC, WEBM, MP4 e MOV.
Códigos de erro
| HTTP | code | Quando acontece | O que fazer |
|---|---|---|---|
| 400 | invalid_body | O corpo não pôde ser lido. | Confira o Content-Type e o corpo. |
| 401 | invalid_api_key | Chave ausente, revogada ou errada. | Confira Authorization: Bearer e a chave no app. |
| 402 | insufficient_balance | O saldo não cobre o áudio. | Recarregue. missing_brl diz quanto falta. |
| 402 | plan_required | Pediu um recurso de IA (como sentiment=true) sem assinatura ativa. | Assine um plano, ou mande sem o recurso. |
| 404 | not_found | O recurso não existe ou é de outra conta. | Confira o id e a chave usada. |
| 409 | idempotency_conflict | Mesma Idempotency-Key com outro corpo. | Gere uma chave nova. |
| 413 | file_too_large | Passou do tamanho do jeito de envio. | Veja arquivos grandes. |
| 413 | audio_too_long | Mais de 4 horas. | Divida o arquivo. |
| 415 | unsupported_media | Formato fora da lista. | Converta para MP3 ou WAV. |
| 422 | invalid_parameter | Um parâmetro tem valor inválido. | param diz qual. |
| 429 | rate_limited | Pedidos demais por minuto. | Espere o Retry-After. |
| 429 | concurrency_limited | Transcrições demais ao mesmo tempo. | Espere uma terminar ou use webhook_url. |
| 503 | gpu_unavailable | O serviço de transcrição está fora do ar. | Tente de novo. Se veio id, consulte depois. |