OneMux/Documentação/Perguntas frequentes

Perguntas frequentes

Encontrou um erro ao fazer uma chamada à API? Localize rapidamente o problema pelo código de status. Esta página lista os códigos de erro mais comuns e suas soluções; a maioria dos problemas pode ser resolvida por conta própria em até 1 minuto.

Diagnóstico rápido

Quando ocorrer um erro no código, primeiro encontre o código de status HTTP (como 401 ou 429) e depois consulte a ação correspondente:

Código de statusCausaSolução
401API Key inválidaVerifique o formato da chave (sk-xxx) e sua validade
402Saldo insuficienteAdicione créditos no console
404ID do modelo incorretoCopie o ID correto na página do modelo
429Solicitações muito rápidasReduza a frequência e tente novamente após 10 segundos
500Falha no serviço upstreamTente novamente mais tarde ou mude de modelo

401 - API Key inválida

Causas mais comuns:

  • Foram adicionados espaços ao copiar
  • Formato incorreto (não começa com sk-)
  • A chave foi excluída

Solução rápida:

# ✅ Formato correto
api_key = "sk-1234567890abcdef"

# ❌ Erros comuns
api_key = " sk-1234567890abcdef "  # há espaços no início e no fim
api_key = "1234567890abcdef"       # falta o prefixo sk-

Acesse o console para copiar novamente ou criar uma nova chave.

402 - Saldo insuficiente

O saldo da conta não é suficiente para pagar esta solicitação.

Acesse o centro de cobrança para adicionar créditos.

Observação: solicitações com contexto longo (como o processamento de 1 milhão de tokens pelo Gemini) pré-autorizam o custo máximo possível. Certifique-se de que o saldo seja suficiente.

404 - Modelo inexistente

Causas comuns:

  • Erro de digitação no ID do modelo
  • Uso de um nome de modelo antigo (por exemplo, gpt-4o foi substituído por gpt-6.1-sol)
  • Caminho incorreto da Base URL

Solução:

Obter o ID correto do modelo

  1. 1

    Acessar a página de modelos

    Abra https://onemux.net/models

  2. 2

    Encontrar o modelo necessário

    Pesquise ou navegue para encontrar o modelo desejado

  3. 3

    Copiar o ID do modelo

    Clique no botão de copiar ou copie manualmente o ID completo

Confirme que a Base URL é https://api.onemux.net/v1 (observe que termina com /v1)

429 - Solicitações muito rápidas

Muitas solicitações foram enviadas em um curto período, acionando o limite de frequência.

Solução:

  • Reduza a frequência das solicitações
  • Aguarde de 10 a 30 segundos e tente novamente
  • Adicione uma lógica de novas tentativas automáticas (consulte a documentação de tratamento de erros)
  • Reduza o número de tarefas simultâneas

500/502/503 - Falha no serviço

O serviço do modelo upstream está temporariamente indisponível.

Solução:

  • Aguarde de 10 a 30 segundos e tente novamente
  • Mude para outro modelo
  • Consulte a página de status para verificar o status do serviço

Ordem de diagnóstico quando não tiver certeza sobre o problema

Diagnóstico passo a passo

  1. 1

    Verificar o saldo

    Faça login no console e confirme que o saldo é suficiente

  2. 2

    Verificar a API Key

    Copie novamente a chave completa e certifique-se de que não há espaços

  3. 3

    Verificar o ID do modelo

    Copie novamente na página do modelo

  4. 4

    Verificar a Base URL

    Confirme que é https://api.onemux.net/v1

  5. 5

    Reiniciar o software

    Salve a configuração e reinicie o cliente