Solução de problemas

Siga o sintoma que corresponde ao que você está vendo. Em quase todos os casos, a guia Logs é o diagnóstico mais rápido: ela mostra o status de cada solicitação e o padrão da falha (uma chave? um modelo? tudo?). Consulte Atividade e logs.

As solicitações estão bloqueadas

Todas as solicitações falham com 402 insufficient_credits

Causa: o módulo não está habilitado para esta instalação ou o saldo pré-pago se esgotou (a guia Overview mostrará "Your balance is depleted. Inference requests will be blocked until you top up."). Para chaves de API, uma instalação em que o Model Router não está habilitado retorna 403 "Model Router is not enabled for this facility".

Correção: habilite o Model Router na página Welcome to Model Router (consulte Primeiros passos) e, em seguida, recarregue o saldo em Budgets & Limits → Balance & Top-up. As solicitações são retomadas momentos depois que o saldo é creditado. Para evitar que isso se repita, ative a recarga automática. Consulte Orçamentos e recargas.

As solicitações falham com 402 budget_exceeded

Causa: um limite de gastos foi atingido. A mensagem de erro informa qual período (diário / mensal / vitalício) e, para os limites diário e mensal, exatamente quando ele é redefinido no fuso horário da sua instalação. Pode ser o limite de toda a conta ou um limite da chave específica ou do serviço conectado (a mensagem diz "This key's" / "This agent's" quando o limite é específico).

Correção: aguarde a redefinição informada, aumente o limite (Budgets & Limits → Spend Limits, ou a configuração da chave ou do serviço) ou, para o teto rígido vitalício, use Reset hard cap. A página Spend Limits mostra exatamente quais limites estão em "Limit reached".

As solicitações falham com 403 content_policy_violation

Causa: o prompt correspondeu a um filtro de conteúdo no modo block ou à proteção contra injeção de prompt.

Correção: revise Settings → Guardrails. Se uma integração precisar legitimamente de regras diferentes, use a opção Override facility guardrails dela em vez de afrouxar a política de toda a instalação. Consulte Guardrails.

As solicitações falham com 429

Causa: a chave ou o serviço conectado excedeu o limite de taxa de Requests / min ou Tokens / min.

Correção: aguarde e tente novamente, ou aumente os limites de taxa na configuração da chave ou do serviço (em branco = ilimitado). Consulte Chaves de API.

Um modelo específico retorna erros, os outros funcionam

Causa: o modelo pode estar desabilitado para sua instalação, excluído pela restrição de modelos da chave, ou o provedor pode estar com problemas.

Correção: verifique Settings → Models (ele está habilitado?), a lista Restrict models da chave e Activity → Performance → Reliability & performance by model para ver a taxa de erros do modelo ao longo do tempo.

Problemas com chaves de API

401 Unauthorized

Causa: com o código invalid_api_key ("Missing or invalid API key"), o cabeçalho Authorization: Bearer … está ausente ou malformado. Sem código ("Invalid API key"), a chave é desconhecida (digitada incorretamente, ou um segredo antigo após um rotate) ou está revoked.

Correção: confirme o formato do cabeçalho e verifique o status da chave em Settings → Service Access & API Keys. Reative uma chave revogada ou atualize seu serviço com o novo segredo se a chave tiver sido rotacionada.

Perdi o segredo da chave

O segredo é mostrado apenas uma vez, na criação, e não pode ser recuperado. Use Rotate: um novo segredo é emitido (mostrado uma vez) e a chave mantém seu rótulo, seus limites e seu histórico. Atualize todos os serviços que usam a chave: "You will need to reconfigure any services still using the old key."

A chave funciona, mas o uso aparece com o nome errado

As chaves são identificadas pelo Label em Activity e Logs. Edite a chave e defina um rótulo significativo; dê a cada sistema sua própria chave em vez de compartilhar uma.

Problemas com agentes

Um agente aparece como Off-line

Causa: o dispositivo está desligado ou sem conectividade. Trata-se da conectividade do dispositivo, não de uma configuração do Model Router.

Correção: verifique a energia e a rede do dispositivo. A configuração de acesso dele não é afetada e volta a funcionar assim que ele se reconecta.

Um agente parou de responder a solicitações de IA

Verifique, nesta ordem:

1. Saldo: um saldo esgotado bloqueia todos os agentes (o agente mostra um estado de créditos necessários). Recarregue o saldo.
2. Limites por serviço: Settings → Service Access & API Keys → Connected Services: o agente mostra "Limit reached"? Aumente o limite ou aguarde a redefinição.
3. Limites da conta: Budgets & Limits → Spend Limits.
4. Logs: filtre pelo agente para ver o erro real nas solicitações dele.

Dúvidas sobre saldo e faturamento

Os valores de gastos parecem atrasados

Os valores Available balance e Spent today são atualizados em tempo real. O Monthly usage é conciliado com o seu saldo a cada 15 minutos, então gastos muito recentes podem levar alguns minutos para aparecer ali. O histórico de transações lista apenas recargas e ajustes de saldo, portanto o uso nunca aparece nele.

A recarga automática não foi executada

Verifique se há um aviso na página Balance & Top-up: nenhum cartão cadastrado, o cartão precisa de autenticação ou o cartão foi recusado. Corrija o cartão (Update card / Edit payment details) ou recarregue manualmente. As verificações de recarga automática são executadas aproximadamente a cada 15 minutos, então um limite recém-ultrapassado pode levar alguns minutos para acionar a recarga.

Uma recarga falhou

"Additional card authentication is required. Please try again.": tente novamente; seu banco pode solicitar uma verificação. "Top-up could not be completed.": a cobrança foi recusada; verifique o cartão ou tente outro valor. Nenhum crédito é aplicado a menos que a cobrança seja bem-sucedida.

Fui cobrado, mas o saldo não mudou

As recargas são creditadas instantaneamente: atualize a página. Se o saldo ainda não refletir uma cobrança bem-sucedida, anote o Transaction ID e o Payment reference no painel de detalhes da transação (ou na fatura do seu cartão) e abra uma solicitação de suporte.

Dúvidas sobre logs e análises

Uma solicitação que acabei de fazer ainda não aparece nos Logs

Ative a atualização Live (ou clique em Refresh now). As solicitações normalmente aparecem em instantes; sob carga, isso pode demorar um pouco mais.

Os logs mostram um modelo que eu não solicitei

Se você enviou model: "auto", os logs mostram o modelo para o qual o Auto Router resolved to: abra os detalhes da solicitação para ver Requested model: auto. Isso é esperado. Consulte Modelos.

As linhas mostram "No charge"

Respostas com falha ou vazias que não custam nada recebem o selo No charge: elas são registradas para fins de completude, mas não consumiram saldo.

Minha exportação CSV é menor do que o esperado

As exportações brutas são limitadas a 25,000 linhas: restrinja o intervalo de datas ou use uma exportação de resumo. Observe também: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."