Integre o Vortixy Chat nos seus projetos com uma chave Bearer. Mesmas cotas do seu plano. Criar chave em Painel → Sua API
Todos os erros seguem RFC 9457 com mensagem localizada. Verifique o campo code para tratamento programático.
{ "error": "You reached the daily quota. Try again after 2h.", "code": "quotaExceeded", "retryAfter": 7200, "resetsInSeconds": 7200, "resetsAt": "2026-09-27T00:00:00.000Z" }
// 429 de cuota diaria: countdown absoluto 00:00 UTC (resetsAt) + relativo
// (resetsInSeconds/Retry-After) + RateLimit-* headers — no derives el reset
// con tu reloj local| Status | Código | Quando |
|---|---|---|
| 400 | validation | JSON inválido ou campo fora do intervalo |
| 401 | apiKeyInvalid | Chave Bearer ausente ou inválida |
| 403 | planRequired | Modelo não permitido para seu plano |
| 403 | byokMissing | Chave BYOK deste provedor não encontrada — salve-a em Dashboard → Configurações → Chaves de IA |
| 429 | quotaExceeded | Cota diária de tokens / requisições / buscas atingida |
| 429 | rateLimited | Requisições demais por minuto — aguarde o Retry-After e tente de novo com backoff |
| 503 | aiEngineUnavailable | Serviço temporariamente indisponível — tente de novo com backoff, veja /api/health |
| 502 | aiEngineFailed | Erro do modelo upstream |
Cabeçalhos: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After, WWW-Authenticate on 401.
Mensal ou anual?
Economize 17% com faturamento anual.